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This book is an introductory text in computer science, focusing on programming 
principles and practices. Why should you choose this book for your first course in 
computer science? Here are the key reasons: 


The book’s point of view goes beyond language syntax and focuses on computer 
science concepts. 


The object-oriented paradigm is emphasized from the outset, exposing you 
to objects and classes from the first chapters so you won't have to un-learn 
occur habits. 


Rather than following a rigid “objects-early” or “objects-late” approach, 
object-oriented concepts are introduced gradually. 


A focus on test-driven development encourages you to test your programs as 
you develop them, giving you greater confidence in the correctness of your 
solutions. 


The book will motivate you to master the practical aspects of programming, with 
lots of useful tips on good software engineering practices. 


The book teaches the standard Java language—not a specialized “training 
wheels” environment. The Java language, library, and tools are presented at a 
depth that is sufficient to solve real-world programming problems. 


In the final chapters of the book, you will learn advanced techniques such as 
multithreading, database storage, XML, and web programming. 
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This book is based on the Java programming language. Java was chosen for four 
reasons: 


e Object orientation 

e Safety 

e Simplicity 

¢ Breadth of the standard library 


At this point, the object-oriented point of view is the predominant paradigm for 
software design. Object orientation enables programmers to spend more time on 
the design of their programs and less time coding and debugging. This book starts 
out with objects and classes early so that readers do not have to un-learn procedural 
programming habits later. 

Safety is an important feature of the Java language, and highly beneficial for 
beginning programmers. Common programming errors are reliably diagnosed 
when a Java program is compiled or executed. Using Java, you will be able to spend 
more time on completing substantial software projects instead of debugging pro- 
grams with mysterious and irreproducible behavior. 

Another major advantage of Java is its simplicity. It is possible to master the 
essential language constructs in a semester-long course. 

Finally, the standard Java library has sufficient breadth that it can be used for 
most courses in a computer science curriculum. Graphics, user-interface construc- 
tion, database access, multithreading, and network programming are all part of the 
standard library. Thus, the skills learned in a beginning course based on Java will 
serve you well in subsequent courses. 


The methodology of test-driven development promises to quickly deliver defect- 
free software by avoiding tedious debugging sessions. The central principle is to 
develop test cases together with, or even in advance of, implementing desired 
behavior. 

In an industrial setting, test-driven development is aided by a set of libraries and 
tools that can be challenging for the beginner to master. In this book, we focus on 
the essential aspect of test-driven development—thinking about the expected 
results while developing a program. Tester programs are required to do no more 
than print the expected result together with any program output. This straight- 
forward requirement encourages you to think more deeply about your programs as 
you develop them. 
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A testing track is distributed over several chapters, starting with Chapter 2. 
Topics range from the development of simple tester programs to regression testing 


and the use of a debugger. 


There has been much discussion in the computer science community as to whether 
object-oriented programming should be introduced “early” or “late”. Neither 
approach is ideal. The “objects gradual” approach used in this book has been fur- 
ther refined in this edition. In Chapter 2, you will learn to use objects and classes 
from the standard library. In Chapter 3, you will learn how to implement classes 
from a given specification. These two chapters allow you to use objects soundly 
when studying the core algorithmic topics in Chapters 4 through 7— without learn- 
ing bad habits that you have to un-learn later. In Chapter 8, you will learn how to 
design the specification of a class. Finally, in Chapter 12, you will learn how to dis- 
cover collaborating classes in order to develop object-oriented solutions to complex 
programming problems. 
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Java 6, released in December 2006, contains a number of useful library enhance- 
ments, principally for user-interface, database, and XML programming. The book 
has been updated to cover these enhancements. The core material is not affected by 
Java 6, and the book can be used equally well with Java 5 or Java 6. 


An optional graphics track is provided because many students enjoy writing pro- 
grams that create drawings, and because graphical shapes are splendid examples of 
objects. All sections in the graphics track can be skipped if desired. 

In this edition, the graphics coverage has been broken up into smaller chunks. 
Chapter 2 contains material on simple drawings, and Chapter 3 describes how to 
implement objects that draw themselves. Chapter 9, which introduces the notion of 
an interface, uses event-driven programming to reinforce the interface concept. 
Chapter 10 covers inheritance, and its graphics section shows how to use inherit- 
ance for customizing frames. Finally, Chapter 18 covers GUI components and their 
layout. 


The first four pages of this book describe an innovative online tool for teachers and 
students: WileyPLUS can be adopted by instructors who wish their students to take 
full advantage of a wide range of online tools for drill and practice, homework and 
quizzing, animations and lab projects. WileyPLUS can be adopted with the book at 
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no additional cost to the student, or as an alternative to the printed text for about 
half the cost of print. WileyPLUS integrates all of the instructor and student web 
resources into an online version of this text. For more information and a demo, 
please visit the web site listed on pages i-iv, or talk to your Wiley representative. 


LabRat: A Programming Assignment Tool 


All programming exercises in this edition have been revised to allow for computer- 
assisted grading. More detailed specifications and starter code for assignments are 
available in the WileyPLUS course that accompanies this book. An innovative tool 
within the WileyPLUS course, LabRat, allows instructors to assign code comple- 
tion and programming exercises online. Students can use LabRat to check that their 
solutions conform to the program specifications before they submit them online for 
grading. LabRat gives instructors a report of the students’ test results, the students’ 
code, and recommended grades that the instructor can accept or override in the 


WileyPLUS gradebook. 


Student and Instructor Resources in WileyPLUS 


The following resources for students and instructors can be found in the Wiley- 
PLUS course for this text: 

¢ Solutions to all exercises (for instructors only) 

e A test bank (for instructors only) 

e A laboratory manual 

e Additional review and programming exercises 

e A list of frequently asked questions 

¢ Help with common compilers 


¢ Lecture presentation slides that summarize each chapter and include code listings 
and figures from the book 


¢ Source code for all examples in the book 


¢ The programming style guide in electronic form, so you can modify it to suit 
local preferences 


¢ A conversion guide for moving from the last edition to this one (for instructors 
only) 


Also available with this text is a Blue] manual that has been customized specifically 
for use with this book. The manual comes with a CD-ROM that contains the Blue] 
software as well as all the code examples from this book, formatted as Blue] 
projects. For more information, please talk to your Wiley representative. 
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The book can be naturally grouped into four parts, as illustrated by Figure 1. The 
organization of chapters offers the same flexibility as the previous edition; depen- 
dencies among the chapters are also shown in the figure. 


Part A: Fundamentals (Chapters 1-7) 


Chapter 1 contains a brief introduction to computer science and Java programming. 
Chapter 2 shows how to manipulate objects of predefined classes. In Chapter 3, 
you will build your own simple classes from given specifications. 

Fundamental data types, branches, loops, and arrays are covered in Chapters 4-7. 


Part B: Object-Oriented Design (Chapters 8-12) 


Chapter 8 takes up the subject of class design in a systematic fashion, and it intro- 
duces a very simple subset of the UML notation. 

The discussion of polymorphism and inheritance is split into two chapters. Chap- 
ter 9 covers interfaces and polymorphism, whereas Chapter 10 covers inheritance. 
Introducing interfaces before inheritance pays off in an important way: Students 
immediately see polymorphism before getting bogged down with technical details 
such as superclass construction. 

Exception handling and basic file input/output are covered in Chapter 11. The 
exception hierarchy gives a useful example for inheritance. 

Chapter 12 contains an introduction to object-oriented design, including two 
significant case studies. 


Part C: Data Structures and Algorithms (Chapters 13-17) 


Chapters 13 through 17 contain an introduction to algorithms and data structures, 
covering recursion, sorting and searching, linked lists, binary trees, and hash tables. 
These topics may be outside the scope of a one-semester course, but can be covered 
as desired after Chapter 7 (see Figure 1). 

Recursion is introduced from an object-oriented point of view: An object that 
solves a problem recursively constructs another object of the same class that solves 
a simpler problem. The idea of having the other object do the simpler job 1s more 
intuitive than having a function call itself. 

Each data structure is presented in the context of the standard Java collections 
library. You will learn the essential abstractions of the standard library (such as 
iterators, sets, and maps) as well as the performance characteristics of the various 
collections. However, a detailed discussion of the implementation of advanced data 
structures is beyond the scope of this book. 

Chapter 17 introduces Java generics. This chapter is suitable for advanced stu- 
dents who want to implement their own generic classes and methods. 
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Part D: Advanced Topics (Chapters 18-24) 


Chapters 18 through 24 cover advanced Java programming techniques that def- 
nitely go beyond a first course in Java. Although, as already mentioned, a compre- 
ensive coverage of the Java library would span many volumes, many instructors 
prefer that a textbook should give students additional reference material valuable 
beyond their first course. Some institutions also teach a second-semester course that 
covers more practical programming aspects such as database and network program- 
ming, rather than the more traditional in-depth material on data structures and algo- 
rithms. This book can be used in a two-semester course to give students an 
introduction to programming fundamentals and broad coverage of applications. 
Alternatively, the material in the final chapters can be useful for student projects. 
The advanced topics include graphical user-interface design, advanced file han- 
dling, multithreading, and those technologies that are of particular interest to 
server-side programming: networking, databases, XML, and web applications. The 
Internet has made it possible to deploy many useful applications on servers, often 
accessed by nothing more than a browser. This server-centric approach to applica- 
tion development was in part made possible by the Java language and libraries, and 
today, much of the industrial use of Java is in server-side programming. 


Appendices 


Appendix A contains a style guide for use with this book. Many instructors find it 
highly beneficial to require a consistent style for all assignments. If this style guide 
conflicts with instructor sentiment or local customs, however, it is available in elec- 
tronic form so that it can be modified. Appendix B lists the Basic Latin and Latin-1 
subsets of Unicode. Appendix C contains an overview of the classes and interfaces 
in the standard library covered in this book. Additional appendices contain quick 
references on Java syntax, HTML, Java tools, binary numbers, UML, and more. 


This edition builds on the pedagogical elements in the last edition and offers addi- 
tional aids for the reader. Each chapter begins with the customary overview of 
chapter objectives and motivational introduction. A listing of the chapter contents 
then provides a quick reference to the special features in the chapter. 

Throughout each chapter, margin notes show where new concepts 
are introduced and provide an outline of key ideas. These notes are 
summarized at the end of the chapter as a chapter review. 

Each section concludes with a set of self-check exercises. Use 
these exercises to check that you have understood the newly intro- 
duced topics. The self-check exercises are not trivial—they are pur- 
posefully designed to make you think through the new material. Answers to the 
self-check exercises are at the end of each chapter. 
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The program listings are carefully designed for easy reading, going well beyond 
simple color coding. Comments are typeset in a separate font that is easier to read 
than the monospaced “computer” font. Methods are set off by a subtle color out- 
line. Keywords, strings, and numbers are color coded as they would be in a devel- 
opment environment such as BlueJ. (The code for all program listings in the book 
(plus any additional files needed for each example) is available in the WileyPLUS 
course for the book.) 

Throughout the chapters, special features set off topics for added flexibility and 
easy reference. Syntax boxes highlight new syntactical constructs and their purpose. 
An alphabetical list of all of these constructs can be found on page xxix. 

Six additional features, entitled “Common Error”, “How To”, “Productivity 
Hint”, “Quality Tip”, “Advanced Topic”, and “Random Fact”, are identified with 
the icons below and set off so they don’t interrupt the flow of the main material. 
Some of these are quite short; others extend over a page. Each topic is given the 
space that is needed for a full and convincing explanation—instead of being forced 
into a one-paragraph “tip”. You can use the tables on pages xxx—xxxvii to see the 
features in each chapter and the page numbers where they can be found. 


e Common Errors describe the kinds of errors that students often make, with an 
explanation of why the errors occur, and what to do about them. Most students 
quickly discover the Common Error sections and read them on their own. 


¢ How To sections are inspired by the Linux HOWTO guides. These sections are 
intended to answer the beginner’s question, “Now what do I do?”, by giving 
step-by-step instructions for common tasks. 


° Quality Tips explain good programming practices. Because most of them require 
an initial investment of effort, these notes carefully motivate the reason behind 
the advice, and explain why the effort will be repaid later. 


¢ Productivity Hints teach students how to use their tools more effectively. Many 
beginning students put little thought into their use of computers and software. 
They are often unfamiliar with tricks of the trade, such as keyboard shortcuts, 
global search and replace, or automation of common tasks with scripts. 


e Advanced Topics cover nonessential or more difficult material. Some of these top- 
ics introduce alternative syntactical constructions that are not necessarily techni- 
cally advanced. In many cases, the book uses one particular language construct 
but explains alternatives as Advanced Topics. You should feel free to use those 
constructs in your own programs if you prefer them. It has, however, been my 
experience that many students are grateful for the “keep it simple” approach, 
because it greatly reduces the number of gratuitous decisions they have to make. 
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e Random Facts provide historical and social information on computing —to 
fulfill the “historical and social context” requirements of the ACM curriculum 
cuidelines—as well as capsule reviews of advanced computer science topics. 
Many students will read the Random Facts on their own while pretending to 
follow the lecture. 
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Introduction 


© To understand the activity of programming 
= To learn about the architecture of computers 


To learn about machine code and hig h-level 
P rogramming lang uages — | 


-® To become familiar with your computing environment 
and your compiler 
® To compile and run your first Java program 


© To recognize syntax and logic errors 


The purpose of this chapter is to familiarize you with the concept of programming. 
It reviews the architecture of a computer and discusses the difference between 
machine code and high-level programming languages. Finally, you will see how to 
compile and run your first Java program, and how to diagnose errors that may 


occur when a program is compiled or executed. 
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You have probably used a computer for work or fun. Many people use computers 
for everyday tasks such as balancing a checkbook or writing a term paper. Comput- 
ers are good for such tasks. They can handle repetitive chores, such as totaling up 
numbers or placing words on a page, without getting bored or exhausted. Comput- 
ers also make good game machines because they can play sequences of sounds and 
pictures, involving the human user in the process. 

The flexibility of a computer is quite an amazing phenomenon. The same 
machine can balance your checkbook, print your term paper, and play a game. In 
contrast, other machines carry out a much narrower range of tasks—a car drives 
and a toaster toasts. 

To achieve this flexibility, the computer must be programmed to 
perform each task. A computer itself is a machine that stores data 
(numbers, words, pictures), interacts with devices (the monitor 
screen, the sound system, the printer), and executes programs. Pro- 
grams are sequences of instructions and decisions that the computer 
carries out to achieve a task. One program balances checkbooks; a 
different program, perhaps designed and constructed by a different 
company, processes words; and a third program, probably from yet 
another company, plays a game. 

Today’s computer programs are so sophisticated that it is hard to 
believe that they are all composed of extremely primitive operations. 
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A typical operation may be one of the following: 


Put a red dot onto this screen position. 


Send the letter A to the printer. 


Get a number from this location in memory. 


Add up two numbers. 


If this value is negative, continue the program at that instruction. 


A computer program tells a computer, in minute detail, the sequence 
of steps that are needed to complete a task. A program contains a 
huge number of simple operations, and the computer executes them 
at great speed. The computer has no intelligence—it simply executes 
instruction sequences that have been prepared in advance. 

To use a computer, no knowledge of programming is required. When you write a 
term paper with a word processor, that software package has been programmed by 
the manufacturer and is ready for you to use. That is only to be expected—you can 
drive a car without being a mechanic and toast bread without being an electrician. 

A primary purpose of this book is to teach you how to design and implement 
computer programs. You will learn how to formulate instructions for all tasks that 
your programs need to execute. 

Keep in mind that programming a sophisticated computer game or word proces- 
sor requires a team of many highly skilled programmers, graphic artists, and other 
professionals. Your first programming efforts will be more mundane. The concepts 
and skills you learn in this book form an important foundation, but you should not 
expect to immediately produce professional software. A typical college program in 
computer science or software engineering takes four years to complete; this book 1s 
intended as an introductory course in such a program. 

Many students find that there is an immense thrill even in simple programming 
tasks. It is an amazing experience to see the computer carry out a task precisely and 
quickly that would take you hours of drudgery. 


SELF CHECK 


1. What is required to play a music CD on a computer? 
2. Why is a CD player less flexible than a computer? 


3. Can a computer program develop the initiative to execute tasks in a better way 
than its programmers envisioned? 


To understand the programming process, you need to have a rudimentary under- 
standing of the building blocks that make up a computer. This section will describe 
a personal computer. Larger computers have faster, larger, or more powerful com- 
ponents, but they have fundamentally the same design. 


At the heart of the 
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Figure 1 Central Processing Unit 


At the heart of the computer lies the central processing unit (CPU) 


computer lies the central (See Figure 1). It consists of a single chip (integrated circuit) or a 


processing unit (CPU). -—«- Small number of chips. A computer chip is a component with a plastic 


Data and programs are 
stored in primary storage _ 
(memory) and secondary _ 


or metal housing, metal connectors, and inside wiring made princi- 
pally from silicon. For a CPU chip, the inside wiring is enormously complicated. 
For example, the Pentium 4 chip (a popular CPU for personal computers at the 
time of this writing) contains over 50 million structural elements called transistors — 
the elements that enable electrical signals to control other electrical signals, making 
automatic computing possible. The CPU locates and executes the program instruc- 
tions; it carries out arithmetic operations such as addition, subtraction, multiplica- 
tion, and division; and it fetches data from storage and input/output devices and 
sends data back. 
The computer keeps data and programs in storage. There are two 
kinds of storage. Primary storage, also called random-access memory 
(RAM) or simply memory, is fast but expensive; it is made from 


storage (suchasa.-—Cremrrry ‘hips (see Figure 2). Primary storage has two disadvantages. 


hard disk). 


It is comparatively expensive, and it loses all its data when the power 

is turned off. Secondary storage, usually a hard disk (see Figure 3), 
provides less expensive storage that persists without electricity. A hard disk consists 
of rotating platters, which are coated with a magnetic material, and read/write 
heads, which can detect and change the patterns of varying magnetic flux on the 
platters. This is essentially the same recording and playback process that is used in 
audio or video tapes. 

Some computers are self-contained units, whereas others are interconnected 
through networks. Home computers are usually intermittently connected to the 
Internet via a dialup or broadband connection. The computers in your computer 
lab are probably permanently connected to a local area network. Through the net- 
work cabling, the computer can read programs from central storage locations or 
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Figure 2 
A Memory Module with Memory Chips 


send data to other computers. For the user of a networked computer, 1t may not 
even be obvious which data reside on the computer itself and which are transmitted 
through the network. 

Most computers have removable storage devices that can access data or programs 
on media such as floppy disks, tapes, or compact discs (CDs). 
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Figure 3. A Hard Disk 
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Figure 4 A Motherboard 


To interact with a human user, a computer requires other peripheral devices. The 
computer transmits information to the user through a display screen, loudspeakers, 
and printers. The user can enter information and directions to the computer by 
using a keyboard or a pointing device such as a mouse. 

The CPU, the RAM, and the electronics controlling the hard disk and other 
devices are interconnected through a set of electrical lines called a bus. Data travel 
along the bus from the system memory and peripheral devices to the CPU and 
back. Figure 4 shows a motherboard, which contains the CPU, the RAM, and con- 
nectors to peripheral devices. 

Figure 5 gives a schematic overview of the architecture of a com- 
puter. Program instructions and data (such as text, numbers, audio, 
or video) are stored on the hard disk, on a CD, or on a network. 
When a program is started, it is brought into memory where it can be 
read by the CPU. The CPU reads the program one instruction at a 
time. As directed by these instructions, the CPU reads data, modifies 
it, and writes it back to RAM or to secondary storage. Some program 
ae ~ instructions will cause the CPU to interact with the devices that 
cones! de display screen or the speaker. Because these actions happen many times 
over and at great speed, the human user will perceive images and sound. Similarly, 
the CPU can send instructions to a printer to mark the paper with patterns of closely 
spaced dots, which a human recognizes as text characters and pictures. Some pro- 
gram instructions read user input from the keyboard or mouse. The program ana- 
lyzes the nature of these inputs and then executes the next appropriate instructions. 
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Figure 5 Schematic Diagram of a Computer 


SELF CHECK 


4. Where is a program stored when it is not currently running? 


5. Which part of the computer carries out arithmetic operations, such as addition 
and multiplication? 


RANDOM FACT 1.1 


The ENIAC and the Dawn of Computing 


The ENIAC (electronic numerical integrator and computer) was the first usable electronic 
computer. It was designed by J. Presper Eckert and John Mauchly at the University of Penn- 
sylvania and was completed in 1946. Instead of transistors, which were not invented until 
two years after it was built, the ENIAC contained about 18,000 vacuum tubes in many cabi- 
nets housed in a large room (see The ENIAC figure). Vacuum tubes burned out at the rate of 
several tubes per day. An attendant with a shopping cart full of tubes constantly made the 
rounds and replaced defective ones. The computer was programmed by connecting wires on 
panels. Each wiring configuration would set up the computer for a particular problem. To 
have the computer work on a different problem, the wires had to be replugged. 

Work on the ENIAC was supported by the U.S. Navy, which was interested in computa- 
tions of ballistic tables that would give the trajectory of a projectile, depending on the wind 
resistance, initial velocity, and atmospheric conditions. To compute the trajectories, one must 
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The ENIAC 


find the numerical solutions of certain differential equations; hence the name “numerical 
integrator”. Before machines like ENIAC were developed, humans did this kind of work, 
and until the 1950s the word “computer” referred to these people. The ENIAC was later 
used for peaceful purposes, such as the tabulation of U.S. census data. 


1.3 Translating Human-Readable Programs to 
Machine Code 


On the most basic level, computer instructions are extremely primi- 
tive. The processor executes machine instructions. CPUs from differ- 
ent vendors, such as the Intel Pentium or the Sun SPARC, have 
set of the Java virtual different sets of machine instructions. To enable Java seplieae das to 
machine JVM) canbe =~ runon multiple CPUs without modification, Java programs contain 
executed on many CPUs. machine instructions for a so-called “Java virtaal machine” (JVM), an 
penis idealized CPU that is simulated by a program run on the actual CPU. 
The difference between actual and virtual machine instructions is not important— 
all you need to know is that machine instructions are very simple, are encoded as 

numbers and stored in memory, and can be executed very quickly. 


Generally, machine code 
depends on the CPU type. 
However, the instru ic 
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A typical sequence of machine instructions 1s 


1. Load the contents of memory location 40. 
2. Load the value 100. 


3. If the first value is greater than the second value, continue with the instruction 
that is stored in memory location 240. 


Actually, machine instructions are encoded as numbers so that they can be stored in 
memory. On the Java virtual machine, this sequence of instruction is encoded as the 
sequence of numbers 


21 40 
16 100 
163 240 


When the virtual machine fetches this sequence of numbers, it decodes them and 
executes the associated sequence of commands. 
aT How can you communicate the command sequence to the com- 

puter? The most direct method is to place the actual numbers into the 
computer memory. This is, in fact, how the very earliest computers 
worked. However, a long program is composed of thousands of indi- 
vidual commands, and it is tedious and error-prone to look up the 
numeric codes for all commands and manually place the codes into 
memory. Bs we said before, computers are really good at automating tedious and 
error-prone activities, and it did not take long for computer programmers to realize 
that eprapurers could be harnessed to help in the programming process. 
: In the mid-1950s, high-level programming languages began to 
appear. In these languages, the programmer expresses the idea behind 
the task that needs to be performed, and a special computer program, 
called a compiler, translates the high-level description into machine 
_ instructions for a particular processor. 

For example, in Java, the high-level programming language that you will use in 
this book, you might give the following instruction: 


if CintRate > 100) 
System.out.printInC"Interest rate error”); 


) Because machine 
_ instructions are encode 

as numbers, it is difficult 
oe write programs 


‘than machine co de. — 


This means, “If the interest rate is over 100, display an error message”. It is then the 
job of the compiler program to look at the sequence of characters if (intRate > 
100) and translate that into 


21 40 16 100 163 240 . 


Compilers are quite sophisticated programs. They translate logical 
statements, such as the if statement, into sequences of computations, 
tests, and jumps. They assign memory locations for variables —items 
of information identified by symbolic names—like intRate. In this 

: course, we will generally take the existence of a compiler for granted. 
is you decide to become a professional computer scientist, you may well learn more 
about compiler-writing techniques later in your studies. 


A compiler translates le 
programs written in a_ 
high-level language into. 
machine code. ee : | 
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SELF CHECK 


6. What is the code for the Java virtual machine instruction “Load the contents of 
memory location 100”? 


7. Does a person who uses a computer for office work ever run a compiler? 


In 1991, a group led by James Gosling and Patrick Naughton at Sun 
Microsystems designed a programming language that they code- 
named “Green” for use in consumer devices, such as intelligent tele- 
vision “set-top” boxes. The language was designed to be simple and 
architecture neutral, so that it could be executed on a variety of hard- 
ware. No customer was ever found for this technology. 

Gosling recounts that in 1994 the team realized, “We could write a really cool 
browser. It was one of the few things in the client/server mainstream that needed 
some of the weird things we’d done: architecture neutral, real-time, reliable, secure”. 
Java was introduced to an enthusiastic crowd at the SunWorld exhibition in 1995. 
S62 Since then, Java has grown at a phenomenal rate. Programmers 
have embraced the language because it is simpler than its closest rival, 
C++. In addition, Java has a rich library that makes it possible to 
write portable programs that can bypass proprietary operating sys- 
tems —a feature that was eagerly sought by those who wanted to be 
independent of those proprietary systems and was bitterly fought by their vendors. 
A “micro edition” and an “enterprise edition” of the Java library make Java pro- 
grammers at home on hardware ranging from smart cards and cell phones to the 
largest Internet servers. | 

Because Java was designed for the Internet, it has two attributes that make it very 
suitable for beginners: safety and portability. If you visit a web page that contains 
Java code (so-called applets—see Figure 6 for an example), the code automatically 
starts running. It is important that you can trust that applets are inherently safe. If 
an applet could do something evil, such as damaging data or reading personal infor- 
mation on your computer, then you would be in real danger every time you 
browsed the Web—an unscrupulous designer might put up a web page containing 
dangerous code that would execute on your machine as soon as you visited the 
page. The Java language has an assortment of security features that guarantees that 
no evil applets can run on your computer. As an added benefit, these features also 
help you to learn the language faster. The Java virtual machine can catch many kinds 
of beginners’ mistakes and report them accurately. (In contrast, many beginners’ 
mistakes in the C++ language merely produce programs that act in random and 
contusing ways.) The other benefit of Java is portability. The same Java program 
will run, without change, on Windows, UNIX, Linux, or the Macintosh. This too is 
a requirement for applets. When you visit a web page, the web server that serves up 


Java was designed t 
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Figure 6 An Applet for Visualizing Molecules ([1]) 


the page contents has no idea what computer you are using to browse the Web. It 
simply returns you the portable code that was generated by the Java compiler. The 
virtual machine on your computer executes that portable code. Again, there is a 
benefit for the student. You do not have to learn how to write programs for differ- 
ent operating systems. 

At this time, Java is firmly established as one of the most important languages for 
general-purpose programming as well as for computer science instruction. How- 
ever, although Java is a good language for beginners, it is not perfect, for three 
reasons. 

Because Java was not specifically designed for students, no thought was given to 
making it really simple to write basic programs. A certain amount of technical 
machinery is necessary in Java to write even the simplest programs. This is not a 
problem for professional programmers, but it is a drawback for beginning students. 
As you learn how to program in Java, there will be times when you will be asked to 
be satished with a preliminary explanation and wait for complete details in a later 
chapter. 

Java was revised and extended many times during its lite—see Table 1. In this 
book, we assume that you have Java version 5 or later. 

Finally, you cannot hope to learn all of Java in one semester. The Java language 
itself is relatively simple, but Java contains a vast set of library packages that are 
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required to write useful programs. There are packages for graphics, 
user interface design, cryptography, networking, sound, database 
storage, and many other purposes. Even expert Java programmers 
cannot hope to know the contents of all of the packages—they just 
use those that they need for particular projects. 

Using this book, you should expect to learn a good deal about the 
Java language and about the most important packages. Keep in mind 
that the central goal of this book is not to make you memorize Java minutiae, but to 
teach you how to think about programming. 


Table 1 Java Versions 


Version Year important New Features 
10 1996 
11 1997 Inner classes 
12 1998 Swing, Collections 
13 2000 Performance enhancements 
1.4 2002 Assertions, XML — 
5 2004 Generic classes, enhanced for loop, auto-boxing, enumerations 
6 2006 Library improvements 
SELF CHECK 


8. What are the two most important benefits of the Java language? 


9. How long does it take to learn the entire Java library? 


You may be taking your first programming course as you read this 
book, and you may well be doing your work on an unfamiliar com- 
puter system. Spend some time familiarizing yourself with the com- 
puter. Because computer systems vary widely, this book can only 
give an outline of the steps you need to follow. Using a new and 
unfamiliar computer system can be frustrating, especially if you are 
on your own. Look for training courses that your campus offers, or ask a friend to 
give you a brief tour. 


1.5 = Becoming Familiar with Your Computer 13 


| o | Terminal 
Eile Edit View Terminal Go Help 


~$ cd BigJava/chol 


~/BigJava/chol$ 


Figure 7 
A Shell Window 


Step 1. Log In 


If you use your home computer, you probably don’t need to worry about this step. 
Computers in a lab, however, are usually not open to everyone. You may need an 
account name or number and a password to gain access to such a system. 


Step 2. Locate the Java Compiler 


Computer systems differ greatly in this regard. On some systems you must open a 
shell window (see Figure 7) and type commands to launch the compiler. Other sys- 
tems have an integrated development environment in which you can write and test 
your programs (see Figure 8). Many university labs have information sheets and 
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tutorials that walk you through the tools that are installed in the lab. Instructions 
for several popular compilers are available in WileyPLUS. 


Step 3. Understand Files and Folders 


As a programmer, you will write Java programs, try them out, and improve them. 
Your programs are kept in files. A file is a collection of items of information that are 
kept together, such as the text of a word-processing document or the instructions of 
a Java program. Files have names, and the rules for legal names differ from one sys- 
tem to another. Some systems allow spaces in file names; others don’t. Some distin- 
guish between upper- and lowercase letters; others don’t. Most Java compilers 
require that Java files end in an extension— .java; for example, Test.java. Java file 
names cannot contain spaces, and the distinction between upper- and lowercase let- 
ters 1s important. 

Files are stored in folders or directories. These file containers can be nested. That 
is, a folder can contain not only files but also other folders, which themselves can 
contain more files and folders (see Figure 9). This hierarchy can be quite large, 
especially on networked computers, where some of the files may be on your local 
disk, others elsewhere on the network. While you need not be concerned with 
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Figure 9 
Nested Folders Pb 
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every branch of the hierarchy, you should familiarize yourself with your local envi- 
ronment. Different systems have different ways of showing files and directories. 
Some use a graphical display and let you move around by clicking the mouse on 
folder icons. In other systems, you must enter commands to visit or inspect differ- 
ent locations. 


Step 4. Write a Simple Program 


In the next section, we will introduce a very simple program. You will need to learn 
how to type it in, how to run it, and how to fix mistakes. 


Step 5. Save Your Work 


You will spend many hours typing Java program code and improving 
it. The resulting program files have some value, and you should treat 
them as you would other important property. A conscientious safety 
strategy 1s particularly important for computer files. They are more 
fragile than paper documents or other more tangible objects. It is 
easy to delete a file accidentally, and occasionally files are lost because of a com- 
puter malfunction. Unless you keep a copy, you must then retype the contents. 
Because you probably won’t remember the entire file, you will likely find yourself 
spending almost as much time as you did to enter and improve it in the first place. 
This costs time, and it may cause you to miss deadlines. It is therefore crucial that 
you learn how to safeguard files and that you get in the habit of doing so before 
disaster strikes. You can make safety or backup copies of files by saving copies on a 
floppy or CD, into another folder, to your local area network, or on the Internet. 


SELF CHECK 


10. How are programming projects stored on a computer? 


11. What do you do to protect yourself from data loss when you work on pro- 
gramming projects? 


PRODUCTIVITY HINT 1.1 


Understand the File System 


In recent years, computers have become easier to use for home or office users. Many inessen- 
tial details are now hidden from casual users. For example, many casual users simply place all 
their work inside a default folder (such as “Home” or “My Documents”) and are blissfully 
ignorant about details of the file system. 

But you need to know how to impose an organization on the data that you create. You 
also need to be able to locate and inspect files that are required for translating and running 
Java programs. 
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If you are not comfortable with files and folders, be sure to set aside some time to learn 


about these concepts. Enroll in a short course, or take a web tutorial. Many free tutorials are 
available on the Internet, but unfortunately their locations change frequently. Search the 
Web for “files and folders tutorial” and pick a tutorial that goes beyond the basics. 


PRODUCTIVITY HINT 1.2 


Have a Backup Strategy 


Come up with a strategy for your backups now, before you lose any data. Here are a few 
pointers to keep in mind. 


Select a backup medium. Floppy disks are the traditional choice, but they can be unreliable. 
CD media are more reliable and hold far more information, but they are more expensive. An 
increasingly popular form of backup is Internet file storage. Many people use two levels of 
backup: a folder on the hard disk for quick and dirty backups, and a CD-ROM for higher 
security. (After all, a hard disk can crash—a particularly common problem with laptop 
computers.) 


Back up often. Backing up a file takes only a few seconds, and you will hate yourself if 
you have to spend many hours recreating work that you easily could have saved. 


Rotate backups. Use more than one set of disks or folders for backups, and rotate them. 
That is, first back up onto the first backup destination, then to the second and third, and 
then go back to the first. That way you always have three recent backups. Even if one of 
the floppy disks has a defect, or you messed up one of the backup directories, you can use 
one of the others. 


Back up source files only. The compiler translates the files that you write into files consist- 
ing of machine code. There is no need to back up the machine code files, because you can 
recreate them easily by running the compiler again. Focus your backup activity on those 
files that represent your effort. That way your backups won’t fill up with files that you 
don’t need. 


Pay attention to the backup direction. Backing up involves copying files from one place to 
another. It is important that you do this right—that is, copy from your work location to 
the backup location. If you do it the wrong way, you will overwrite a newer file with an 

older version. 


Check your backups once in a while. Double-check that your backups are where you 
think they are. There is nothing more frustrating than finding out that the backups are not 
there when you need them. This is particularly true if you use a backup program that 
stores files on an unfamiliar device (such as data tape) or in a compressed format. 


Relax before restoring. When you lose a file and need to restore it from backup, you are 
likely to be in an unhappy, nervous state. Take a deep breath and think through the 
recovery process before you start. It is not uncommon for an agitated computer user to 
wipe out the last backup when trying to restore a damaged file. 
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You are now ready to write and run your first Java program. The traditional choice 
for the very first program in a new programming language is a program that dis- 
plays a simple greeting: “Hello, World!”. Let us follow that tradition. Here is the 
“Hello, World!” program in Java. 


ch01/hello/HelloPrinter.java 


1 public class HelloPrinter 


: public static void main(String[] args) 
5 // Display a greeting in the console window 
: System.out.printInC"Hello, World!"); 
S 
Output 


Hello, World! 


We will examine this program in a minute. For now, you should make a new pro- 
gram file and call it HelloPrinter. java. Enter the program instructions and compile 
and run the program, following the procedure that is appropriate for your compiler. 

Java 1s case sensitive. You must enter upper- and lowercase letters 
exactly as they appear in the program listing. You cannot type MAIN 
or PrintLn. If you are not careful, you will run into problems—see 
Common Error 1.2. 

On the other hand, Java has free-form layout. You can use any 
number of spaces and line breaks to separate words. You can cram as 
many words as possible into each line, 


public class HelloPrinter{public static void main(String[] 
args){// Display a greeting in the console window 
System.out.printInC"Hello, World!");}} 


You can even write every word and symbol on a separate line, 


public 

class 
HelloPrinter 
i 

public 
static 

void 

main 


C 
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However, good taste dictates that you lay out your programs in a 
readable fashion. We will give you recommendations for good layout 
throughout this book. Appendix A contains a summary of our 
recommendations. 

When you run the test program, the message 


Hello, World! 


will appear somewhere on the screen (see Figures 10 and 11). The exact location 
depends on your programming environment. 
Now that you have seen the program working, it is time to understand its makeup. 


The first line, 


public class HelloPrinter 


starts a new class. Classes are a fundamental concept in Java, and you 
will begin to study them in Chapter 2. In Java, every program con- 

1g -—s sists of one or more classes. 
ieee The keyword public denotes that the class is usable by the “public”. 
You will later encounter private features. At this point, you should 


simply regard the 


Classes a are oe 


public class ClassName 


{ 
} 


as a necessary part of the “plumbing” that is required to write any Java program. In 
Java, every source file can contain at most one public class, and the name of the 
public class must match the name of the file containing the class. For example, the 
class HelloPrinter must be contained in a file HelloPrinter.java. It is very impor- 
tant that the names and the capitalization match exactly. You can get strange error 
messages if you call the class HELLOPrinter or the file hel loprinter. java. 
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Figure 10 Running the Hel loPrinter Program in a Console Window 
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‘/ Display a greeting in the console window 
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Figure 11 
Running the Hel loPrinter Program in an Integrated Development Environment 


The construction 


public static void main(String[] args) 
{ 
} 


defines a method called main. A method contains a collection of pro- 
gramming instructions that describe how to carry out a particular 
task. Every Java application must have a main method. Most Java 
programs contain other methods besides main, and you will see in 
Chapter 3 how to write other methods. 

The parameter String[] args is a required part of the main 
method. (It contains command line arguments, which we will not 
discuss until Chapter 11.) The keyword static indicates that the main 
method does not operate on an object. (As you will see in Chapter 2, 
most methods in Java do operate on objects, and static methods are not common 
in large Java programs. Nevertheless, main must always be static, because it starts 
running before the program can create objects.) 
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At this time, simply consider 


public class ClassName 


{ 
public static void main(String[] args) 
{ 
} 

} 


as yet another part of the “plumbing”. Our first program has all instructions inside 
the main method of a class. 
The first line inside the main method 1s a comment 


// Display a greeting in the console window 


This comment is purely for the benefit of the human reader, to 
explain in more detail what the next statement does. Any text 
enclosed between // and the end of the line is completely ignored by 
the compiler. Comments are used to explain the program to other 
programmers or to yourself. 

The instructions or statements in the body of the main method —that is, the state- 
ments inside the curly braces ({})—are executed one by one. Each statement ends in 
a semicolon (;). Our method has a single statement: 


System.out.printInC"Hello, World!"); 


This statement prints a line of text, namely “Hello, World!”. However, there are 
many places where a program can send that string: to a window, to a file, or to a net- 
worked computer on the other side of the world. You need to specify that the desti- 
nation for the string is the system output—that is, a console window. The console 
window is represented in Java by an object called out. Just as you needed to place 
the main method in a HelloPrinter class, the designers of the Java library needed to 
place the out object into a class. They placed it in the System class, which contains 
useful objects and methods to access system resources. To use the out object in the 
System class, you must refer to it as System. out. 

To use an object, such as System.out, you specify what you want to do to it. In 
this case, you want to print a line of text. The print1n method carries out this task. 

You do not have to implement this method—the programmers who wrote the 
Java library already did that for us—but you do need to call the method. 

Whenever you call a method in Java, you need to specify three 
items (see Figure 12): 


1. The object that you want to use (in this case, System. out) 


2. The name of the method you want to use (in this case, print1n) 


3. A pair of parentheses, containing any other information the 
method needs (in this case, "Hello, World!"). The technical 
term for this information is a parameter for the method. Note 
that the two periods in System. out.printin have different 
meanings. The first period means “locate the out object in the 
System class”. The second period means “apply the print1n 
method to that object”. 
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Object Method Parameters 


Figure 12 
Calling a Method System.out.printInC"Hello, World!") 


A sequence of characters enclosed in quotation marks 
“Hello, World!" 


is called a string. You must enclose the contents of the string inside 
quotation marks so that the compiler knows you literally mean 
"Hello, World!". There is a reason for this requirement. Suppose you 
: need to print the word main. By enclosing it in quotation marks, 
"main", the compiler knows you mean the sequence of characters m a i n, not the 
method named main. The rule is simply that you must enclose all text strings in quo- 
tation marks, so that the compiler considers them plain text and does not try to 
interpret them as program instructions. 
You can also print numerical values. For example, the statement 


System.out.printIn(@3 + 4); 


displays the number 7. 
The printin method prints a string or a number and then starts a new line. For 
example, the sequence of statements 


System.out.printInC"Hello"); 
System.out.printInC"World!"); 


prints two lines of text: 


Hello 
World! 


There is a second method, called print, that you can use to print an item without 
starting a new line. For example, the output of the two statements 


System.out.print ("00"); 
System.out.printin(3 + 4); 


is the single line 
007 


SYNTAX 1.1 Method Call 


object.methodName (parameters) 


Example: 


System.out.printIn("Hello, Dave!") 


Purpose: 


To invoke a method on an object and supply any additional parameters 
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SELF CHECK 


12. How would you modify the He11oPrinter program to print the words “Hello,” 
and “World!” on two lines? 


13. Would the program continue to work if you omitted the line starting with //? 
14. What does the following set of statements print? 


System.out.print("My lucky number is"); 
System.out.printIn(3 + 4 + 5); 


COMMON ERROR 1.1 


Omitting Semicolons 


In Java every statement must end in a semicolon. Forgetting to type a semicolon is a com- 
mon error. It confuses the compiler, because the compiler uses the semicolon to find where 
one statement ends and the next one starts. The compiler does not use line breaks or closing 
braces to recognize the end of statements. For example, the compiler considers 


System.out.printIn("Hel lo") 
System.out.printInC"World!"); 


a single statement, as if you had written 
System.out.printIn ("Hello") System.out.printInC"World!"); 


Then it doesn’t understand that statement, because it does not expect the word System fol- 
lowing the closing parenthesis after "Hello". The remedy is simple. Scan every statement for 
a terminating semicolon, just as you would check that every English sentence ends in a 
period. 


ADVANCED TOPIC 1.1 


Alternative Comment Syntax 


In Java there are two methods for writing comments. You already learned that the compiler 
ignores anything that you type between // and the end of the current line. The compiler also 
ignores any text between a /* and. */. 


/* A simple Java program */ 
The // comment is easier to type if the comment is only a single line long. If you have a com- 
ment that is longer than a line, then the /* . . . */ comment is simpler: 
i ° e e 
This is a simple Java program that you can use to try out 


your compiler and virtual machine. 
* / 


It would be somewhat tedious to add the // at the beginning of each line and to move them 
around whenever the text of the comment changes. 
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In this book, we use // for comments that will never grow beyond aline,and/* . . . */ 
tor longer comments. If you prefer, you can always use the // style. The readers of your code 
will be grateful for any comments, no matter which style you use. 


Experiment a little with the HelloPrinter program. What happens if you make a 
typing error such as 


System.ouch.printInC"Hello, World!"); 
System.out.printInC"Hello, World!); 
System.out.printInC"Hello, Word!"); 


In the first case, the compiler will complain. It will say that it has no 
clue what you mean by ouch. The exact wording of the error message 
is dependent on the compiler, but it might be something like “Unde- 
fined symbol ouch”. This is a compile-time error or syntax error. 
Something is wrong according to the language rules and the compiler 
, finds it. When the compiler finds one or more errors, it refuses to 
translate the program to Java virtual machine instructions, and as a consequence 
you have no program that you can run. You must fix the error and compile again. In 
fact, the compiler is quite picky, and it is common to go through several rounds of 
fixing compile-time errors before compilation succeeds for the first time. 

If the compiler finds an error, it will not simply stop and give up. It will try to 
report as many errors as it can find, so you can fix them all at once. Sometimes, 
however, one error throws it off track. This is likely to happen with the error in the 
second line. Because the closing quotation mark is missing, the compiler will think 
that the ); characters are still part of the string. In such cases, it is common for the 
compiler to emit bogus error reports for neighboring lines. You should fix only 
those error messages that make sense to you and then recompile. 

The error in the third line is of a different kind. The program will compile and 
run, but its output will be wrong. It will print 


Hello, Word! 


This is a run-time error or logic error. The program is syntactically 
correct and does something, but it doesn’t do what it is supposed to 
do. The compiler cannot find the error. You, the programmer, must 
flush out this type of error. Run the program, and carefully look at 
its output. 
During program development, errors are unavoidable. Once a pro- 
, gram 1s longer than a few lines, it requires superhuman concentration 
to enter it correctly without slipping up once. You will find yourself omitting semi- 
colons or quotes more often than you would like, but the compiler will track down 
these problems for you. 
Logic errors are more troublesome. The compiler will not find them—in fact, the 
compiler will cheerfully translate any program as long as its syntax is correct—but 
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the resulting program will do something wrong. It is the responsibility of the pro- 
gram author to test the program and find any logic errors. Testing programs 1s an 
important topic that you will encounter many times in this book. Another impor- 
tant aspect of good craftsmanship is defensive programming: structuring programs 
and development processes in such a way that an error in one part of a program 
does not trigger a disastrous response. 

The error examples that you saw so far were not difficult to diagnose or fix, but 
as you learn more sophisticated programming techniques, there will also be much 
more room for error. It is an uncomfortable fact that locating all errors in a program 
is very difficult. Even if you can observe that a program exhibits faulty behavior, it 
may not at all be obvious what part of the program caused it and how you can fix it. 
Special software tools (so-called debuggers) let you trace through a program to find 
bugs—that is, logic errors. In Chapter 6 you will learn how to use a debugger 
effectively. 

Note that these errors are different from the types of errors that you are likely to 
make in calculations. If you total up a column of numbers, you may miss a minus 
sign or accidentally drop a carry, perhaps because you are bored or tired. Comput- 
ers do not make these kinds of errors. 

This book uses a three-part error management strategy. First, you will learn 
about common errors and how to avoid them. Then you will learn defensive pro- 
gramming strategies to minimize the likelihood and impact of errors. Finally, you 
will learn debugging strategies to flush out those errors that remain. 


SELF CHECK 


15. Suppose you omit the // characters from the Hel1oPrinter. java program but 
not the remainder of the comment. Will you get a compile-time error or a run- 
time error? 


16. How can you find logic errors in a program? 


COMMON ERROR 1.2 


Misspelling Words 


If you accidentally misspell a word, then strange things may happen, and it may not always 
be completely obvious from the error messages what went wrong. Here is a good example of 
how simple spelling errors can cause trouble: 


public class HelloPrinter 


{ 
public static void Main(String[] args) 
{ 
System.out.printInC"Hello, World!"); 
} 
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This class defines a method called Main. The compiler will not consider this to be the same as 
the main method, because Main starts with an uppercase letter and the Java language is case 
sensitive. Upper- and lowercase letters are considered to be completely different from each 
other, and to the compiler Main is no better match for main than rain. The compiler will 
cheerfully compile your Main method, but when the Java virtual machine reads the compiled 
file, it will complain about the missing main method and refuse to run the program. Of 
course, the message “missing main method” should give you a clue where to look for the 
error. 

If you get an error message that seems to indicate that the compiler is on the wrong track, 
it is a good idea to check for spelling and capitalization. All Java keywords use only lower- 
case letters. Names of classes usually start with an uppercase letter, names of methods and 
variables with a lowercase letter. If you misspell the name of a symbol (for example, ouch 
instead of out), the compiler will complain about an “undefined symbol”. That error mes- 
sage 1s usually a good clue that you made a spelling error. 


Some Java development environments are very convenient to use. Enter the code in 
one window, click on a button to compile, and click on another button to execute 
your program. Error messages show up in a second window, and the program runs 
in a third window. With such an environment you are completely shielded from the 
details of the compilation process. On other systems you must carry out every step 
manually, by typing commands into a shell window. 

No matter which compilation environment you use, you begin 
your activity by typing in the program statements. The program that 
you use for entering and modifying the program text is called an edi- 
tor. Remember to save your work to disk frequently, because other- 
wise the text editor stores the text only in the computer’s memory. If 
something goes wrong with the computer and you need to restart it, the contents of 
the primary memory (including your program text) are lost, but anything stored on 
the hard disk is permanent even if you need to restart the computer. 

When you compile your program, the compiler translates the Java 
source code (that is, the statements that you wrote) into class files, 
which consist of virtual machine instructions and other information 
that is required for execution. The class files have the extension 
.class. For example, the virtual machine instructions for the He11o- 
ee Printer program are stored ina file HelloPrinter.class. As already 
mentioned, the compiler produces a class file only after you have corrected all syn- 
tax errors. | 

The class file contains the translation of only the instructions that you wrote. 
That is not enough to actually run the program. To display a string in a window, 
quite a bit of low-level activity is necessary. The authors of the System and Print- 
Stream classes (which define the out object and the printin method) have imple- 
mented all necessary actions and placed the required class files into a library. A 


entering and modifying 
text, such a | 
program. — 


‘The Java compiler 
translates source code 

_ into class files that contain 
instructions for the Java 
virtual machine. 
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Re oe ‘Virtual 
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| Running 
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Figure 13 From Source Code to Running Program 
library is a collection of code that has been programmed and translated by someone 
else, ready for you to use in your program. 
The Java virtual machine loads the instructions for the program that you wrote, 
starts your program, and loads the necessary library files as they are required. 
The steps of compiling and running your program are outlined in Figure 13. 
Begin 
Edit 
program — 
“Compile — 
Pings 
a », rue 
False 
Tee : 
program 
oe a 
error? ' 
, False 
Figure 14 


The Edit-Compile—Test Loop End 
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Programming activity centers around these steps. Start in the edi- 
tor, writing the source file. Compile the program and look at the error 
messages. Go back to the editor and fix the syntax errors. When the 
compiler succeeds, run the program. If you find a run-time error, you 
must look at the source code in the editor to try to determine the reason. 
ute you find the cause of the error, fix it in the editor. Compile and run again to 
see whether the error has gone away. If not, go back to the editor. This is called the 
edit—compile-test loop (see Figure 14). You will spend a substantial amount of time 
in this loop when working on programming assignments. 


SELF CHECK 


17. What do you expect to see when you load a class file into your text editor? 


18. Why can’t you test a program for run-time errors when it has compiler errors? 


CHAPTER SUMMARY 


1. A computer must be programmed to perform tasks. Different tasks require 
different programs. 


2. A computer program executes a sequence of very basic operations in rapid 
succession. 


3. A computer program contains the instruction sequences for all tasks that it can 
execute. 


4. At the heart of the computer lies the central processing unit (CPU). 


5. Data and programs are stored in primary storage (memory) and secondary stor- 


age (such as a hard disk). 


6. The CPU reads machine instructions from memory. The instructions direct it 
to communicate with memory, secondary storage, and peripheral devices. 


7. Generally, machine code depends on the CPU type. However, the instruction 
set of the Java virtual machine (JVM) can be executed on many CPUs. 


8. Because machine instructions are encoded as numbers, it is difficult to write 
programs in machine code. 


9. High-level languages allow you to describe tasks at a higher conceptual level 
than machine code. 


10. A compiler translates programs written in a high-level language into machine 
code. 


11. Java was originally designed for programming consumer devices, but it was first 
successfully used to write Internet applets. 
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12. Java was designed to be safe and portable, benefiting both Internet users and 
students. 


13. Java has a very large library. Focus on learning those parts of the library that 
you need for your programming projects. 


14. Set aside some time to become familiar with the computer system and the Java 
compiler that you will use tor your class work. 


15. Develop a strategy for keeping backup copies of your work before disaster 
strikes. 


16. Java is case sensitive. You must be careful about distinguishing between upper- 
and lowercase letters. 


17. Lay out your programs so that they are easy to read. 
18. Classes are the fundamental building blocks of Java programs. 


19. Every Java application contains a class with a main method. When the applica- 
tion starts, the instructions in the main method are executed. 


20. Each class contains definitions of methods. Each method contains a sequence of 
instructions. 


21. Use comments to help human readers understand your program. 


22. A method is called by specifying an object, the method name, and the method 
parameters. 


23. A string is a sequence of characters enclosed in quotation marks. 


24. A syntax error is a violation of the rules of the programming language. The 
compiler detects syntax errors. 


25. A logic error causes a program to take an action that the programmer did not 
intend. You must test your programs to find logic errors. 


26. An editor is a program for entering and modifying text, such as a Java program. 


27. ‘The Java compiler translates source code into class files that contain instruc- 
tions for the Java virtual machine. 


28. The Java virtual machine loads program instructions from class files and library 


files. 


FURTHER READING 


1. http://jmol.sourceforge.net/applet/ The web site for the jmol applet for 
visualizing molecules. 
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CLASSES, OBJECTS, AND METHODS 
INTRODUCED IN THIS CHAPTER 


Here is a list of all classes, methods, static variables, and constants introduced in this 
chapter. Turn to the documentation in Appendix C for more information. 


java.io.PrintStream 
print 
printIn 

java. lang.System 
out 


REVIEW EXERCISES 


Exercise R1.1. Explain the difference between using a computer program and pro- 
gramming a computer. 


Exercise R1.2. What distinguishes a computer from a typical household appliance? 


Exercise R1.3. Rank the storage devices that can be part of a computer system by 
a. Speed 
b. Cost 
c. Storage capacity 


Exercise R1.4. What is the Java virtual machine? 

Exercise R1.5. What is an applet? 

Exercise R1.6. What is an integrated programming environment? 
Exercise R1.7. What is a console window? 


Exercise R1.8. Describe exactly what steps you would take to back up your work 
after you have typed in the HelloPrinter. java program. 


Exercise R1.9. On your own computer or on a lab computer, find the exact location 
(folder or directory name) of 

a. The sample file HelloPrinter. java, which you wrote with the editor 

b. The Java program launcher java.exe or java 

ce. The library file rt. jar that contains the run-time library 


Exercise R1.10. How do you discover syntax errors? How do you discover logic 
errors? 


Exercise R1.11. Write three versions of the HelloPrinter. java program that have 
different syntax errors. Write a version that has a logic error. 
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Exercise R1.12. What do the following statements print? Don’t guess; write 
programs to find out. 


a. System.out.printIn¢("3 + 4"); 
b. System.out.printIn(3 + 4); 
c. System.out.printin(¢3 + "4"); 


Additional review exercises are available in WileyPLUS. 


PROGRAMMING EXERCISES 


Exercise P1.1. Write a program NamePrinter that displays your name inside a box on 
the console screen, like this: 


Do your best to approximate lines with characters, such as |, -, and +. 


Exercise P1.2. Write a program FacePrinter that prints a face, using text characters, 
hopefully better looking than this one: 


Use comments to indicate the statements that print the hair, ears, mouth, and so on. 


Exercise P1.3. Write a program TicTacToeBoardPrinter that prints a tic-tac-toe board: 
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Exercise P1.5. Write a program that computes the sum of the first ten positive 
integers, 1+2+---+10. Hint: Write a program of the form 


public class Sum10 
| 


public static void main(String[] args) 


{ 
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System. out.printin( be 
} 
; 


Exercise P1.6. Write a program Sum10Reciprocals that computes the sum of the recip- 
rocals 1/1 + 1/2 +---+ 1/10. This is harder than it sounds. Try writing the program, 
and check the result. The program’s result isn’t likely to be correct. Then write the 
denominators as floating-point numbers, 1.0, 2.0,..., 10.0, and run the program 
again. Can you explain the difference in the results? We will explore this phenomenon 
in Chapter 4. 


Exercise P1.7. Type in and run the following program: 


import javax.swing.JOptionPane; 


public class DialogViewer 


{ 
public static void main(String[] args) 
{ 
JOptionPane.showMessageDialog(null, "Hello, World!"); 
System.exit(O); 
} 
} 


Then modity the program to show the message “Hello, your name!”. 


Exercise P1.8. Type in and run the following program: 


import javax.swing.JOptionPane; 


public class DialogViewer 


{ 
public static void main(String[] args) 
{ 
String name = JOptionPane.showInputDialogC"What is your name?") ; 
System.out.printInCname) ; 
System.exit(0); 
} 
} 


Then modify the program to print “Hello, name!”, displaying the name that the 
user typed in. 


Additional programming exercises are available in WileyPLUS. 


PROGRAMMING PROJECTS 


Project 1.1. This project builds on Exercises P1.7 and P1.8. Your program should 
read the user’s name, then show a sequence of two dialog boxes: 


e First, an input dialog box that asks: “What would you like me to do?” 


e Then a message dialog box that says: “I’m sorry, (your name). I’m atraid I 
can’t do that.” 
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ANSWERS TO SELF-CHECK QUESTIONS 


1. 


A program that reads the data on the CD and sends output to the speakers and 
the screen. 


2. ACD player can do one thing—play music CDs. It cannot execute programs. 


we 


Sy HD oO 


. No—the program simply executes the instruction sequences that the program- 


mers have prepared in advance. 


. In secondary storage, typically a hard disk. 
. The central processing unit. 
. 21100 


. No—a compiler is intended for programmers, to translate high-level program- 


ming instructions into machine code. 


. Safety and portability. 

. No one person can learn the entire library —it is too large. 

. Programs are stored in files, and files are stored in folders or directories. 

. You back up your files and folders. 

. System.out.printinC"Hello,"); System.out.printInC'World!"); 

. Yes—the line starting with // is a comment, intended for human readers. The 


compiler ignores comments. 


. The printout is My lucky number is12. It would be a good idea to add a space 


after the is. 


. A compile-time error. The compiler will not know what to do with the word 


Display. 


. You need to run the program and observe its behavior. 
. A sequence of random characters, some funny-looking. Class files contain vir- 


tual machine instructions that are encoded as binary numbers. 


18. When a program has compiler errors, no class file is produced, and there is 


nothing to run. 


G To write programs that display simple shapes 


To understand the concepts of classes and objects 
_To be able to call methods 


To learn about Ralamels and return values — 


To realize the difference between objects and object ieee ecces 


birt 


To learn about variables 


To implement test programs — 


To be able to browse the API documentation : stad 


Most useful programs don’t just manipulate numbers and strings. Instead, they 
deal with data items that are more complex and that more closely represent entities 
in the real world. Examples of these data items include bank accounts, employee 
records, and graphical shapes. 

The Java language is ideally suited for designing and manipulating such data 
items, or objects. In Java, you define classes that describe the behavior of these 
objects. In this chapter, you will learn how to manipulate objects that belong to 
predefined classes. This knowledge will prepare you for the next chapter 1 in which 


you will learn how to implement your own classes. 
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In Java, every value has a type. For example, "Hello, World" has the 
type String, the object System.out has the type PrintStream, and the 
number 13 has the type int (an abbreviation for “integer”). The type 
tells you what you can do with the values. You can call printin on any object of 
type PrintStream. You can compute the sum or product of any two integers. 

You often want to store values so that you can use them at a later time. To 
remember an object, you need to hold it in a variable. A variable is a storage loca- 
tion in the computer’s memory that has a type, a name, and a contents. For example, 
here we declare three variables: 


String greeting = "Hello, World!"; 
PrintStream printer = System.out; 
int luckyNumber = 13; 
The first variable is called greeting. It can be used to store String val- 
ues, and it is set to the value "Hello, World!". The second variable 
stores a PrintStream value, and the third stores an integer. 

Variables can be used in place of the objects that they store: 


printer.printiIn(greeting); // Same as System.out.printIn("Hello, World!") 
printer.printInCluckyNumber); // Same as System. out.printIn(13) 
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SYNTAX 2.1 Variable Definition 


typeName variableName = value; 
or 
typeName variableName; 


Example: 


String greeting = "Hello, Dave!"; 


Purpose: 


To define a new variable of a particular type and optionally supply an initial value 


When you declare your own variables, you need to make two decisions. 


e What type should you use for the variable? 
e What name should you give the variable? 


The type depends on the intended use. If you need to store a string, use the String 
type for your variable. 

It is an error to store a value whose class does not match the type of the variable. 
For example, the following is an error: 


String greeting = 13; // ERROR: Types don’t match 


You cannot use a String variable to store an integer. The compiler checks type mis- 
matches to protect you from errors. 

When deciding on a name for a variable, you should make a choice 
that describes the purpose of the variable. For example, the variable 
name greeting is a better choice than the name g. 

An identifier is the name of a variable, method, or class. Java 
imposes the following rules for identifiers: 


methods, and classes are 
and underscore character. 


e Identifiers can be made up of letters, digits, and the underscore (_) and dollar sign 
($) characters. They cannot start with a digit, though. For example, greeting] 1s 
legal but lgreeting Is not. 


e You cannot use other symbols such as ? or %. For example, he11o! is not a legal 
identifier. 


e Spaces are not permitted inside identifiers. Therefore, lucky number is not legal. 


e Furthermore, you cannot use reserved words, such as public, as names; these 
words are reserved exclusively for their special Java meanings. 


e Identifiers are also case sensitive; that is, greeting and Greeting are different. 


a Be eas These are firm rules of the Java language. If you violate one of them, 
ses should start witha the compiler will report an error. Moreover, there are a couple of 


names should start with 
‘lowercase letter, .-—=S—~SCSM MVE’ that: you should follow so that other programmers will 
ee find your programs easy to read: 
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e Variable and method names should start with a lowercase letter. It is OK to use 
an occasional uppercase letter, such as luckyNumber. This mixture of lowercase 
and uppercase letters is sometimes called “camel case” because the uppercase let- 
ters stick out like the humps of a camel. 


e Class names should start with an uppercase letter. For example, Greeting would 
be an appropriate name for a class, but not for a variable. 


If you violate these conventions, the compiler won’t complain, but you will confuse 
other programmers who read your code. 


SELF CHECK 


1. What is the type of the values 0 and "0"? 
2. Which of the following are legal identifiers? 


Greetingl 


g 

void 
101dalmatians 
Hello, World 
<greeting> 


3. Define a variable to hold your name. Use camel case in the variable name. 


2.2 TheA 


Use the anelusnnenee You can change the value of an existing variable with the assignment 
operator (=) to change the Operator (=). For example, consider the variable definition 


value ofa variable. Int luckyNumber = 13; Ge 


If you want to change the value of the variable, simply assign the new value: 
JuckyNumber = 12; a 


The assignment replaces the original value of the variable (see Figure 1). 

In the Java programming language, the = operator denotes an action, to replace 
the value of a variable. This usage differs from the traditional usage of the = symbol, 
as a statement about equality. 


© uciynunber = 3 


Il 
a) 


Figure 1 
Assigning a New Value to a Variable 


All variables must coe 
initialized b ore you 
access them. 


Objects are entities in 


| mldeiahicilcela Gene ‘“!t 
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Figure 2 onan 
An Uninitialized Object Variable _luckyNumber = 


It is an error to use a variable that has never had a value assigned to it. For exam- 
ple, the sequence of statements 


int luckyNumber; 

System.out.printIn(luckyNumber); // ERROR —uninitialized variable 
is an error. The compiler will complain about an “uninitialized variable” when you 
use a variable that has never been assigned a value. (See Figure 2.) 
The remedy is to assign a value to the variable before you use it: 


int luckyNumber; 
luckyNumber = 13; 
System.out.printIn(luckyNumber); // OK 


Or, even better, initialize the variable when you define it. 


int JuckyNumber = 13; 
System.out.printInCluckyNumber); // OK 


SYNTAX 2.2 Assignment 


variableName = value; 


Example: 


luckyNumber = 12; 


Purpose: 


To assign a new value to a previously defined variable 


SELF CHECK 


4. Is12 = 12 valid expression in the Java language? 


5. How do you change the value of the greeting variable to "Hello, Nina!"? 


An object is an entity that you can manipulate in your program. You 


‘your program that you don’t usually know how the object is organized internally. However, 
“manipulate by calling the object has well-defined behavior, and that is what matters to us 


: methods. 


when we use it. 
You manipulate an object by calling one or more of its methods. A 
method consists of a sequence of instructions that accesses the internal 
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Figure 3 
Representation of the System. out Object 


data. When you call the method, you do not know exactly what 
those instructions are, but you do know the purpose of the method. 

For example, you saw in Chapter 1 that System.out refers to an 
object. You manipulate it by calling the printIn method. When the 
printin method is called, some activities occur inside the object, and 
the ultimate effect is that text appears in the console window. You don’t know how 
that happens, and that’s OK. What matters is that the method carries out the work 
that you requested. 

Figure 3 shows a representation of the System.out object. The internal data is 
symbolized by a sequence of zeroes and ones. Think of each method (symbolized 
by the gears) as a piece of machinery that carries out its assigned task. 

In Chapter 1, you encountered two objects: 


® System.out 
® "Hello, World!" 


These objects belong to different classes. The System.out object belongs to the class 
PrintStream. The "Hello, World!" object belongs to the class String. A class speci- 
fies the methods that you can apply to its objects. 

You can use the printIn method with any object that belongs to 
the PrintStream class. System.out is one such object. It is possible to 
obtain other objects of the PrintStream class. For example, you can 
construct a PrintStream object to send output to a file. However, we 
won't discuss files until Chapter 11. 

Just as the PrintStream class provides methods such as print1n and print for its 
objects, the String class provides methods that you can apply to String objects. 
One of them is the length method. The length method counts the number of 
characters in a string. You can apply that method to any object of type String. For 
example, the sequence of statements 


String greeting = "Hello, World!"; 

int n = greeting. length(); 
sets n to the number of characters in the String object "Hello, World!". After the 
instructions in the length method are executed, n is set to 13. (The quotation marks 
are not part of the string, and the length method does not count them.) 

The length method—unlike the printin method—requires no input inside the 
parentheses. However, the length method yields an output, namely the character count. 
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Figure 4 A Representation of Two String Objects 


In the next section, you will see in greater detail how to supply method inputs 
and obtain method outputs. 

Let us look at another method of the String class. When you apply the 
toUpperCase method to a String object, the method creates another String object 
that contains the characters of the original string, with lowercase letters converted 
to uppercase. For example, the sequence of statements 

String river = "Mississippi"; 

String bigRiver = river.toUpperCase() ; 
sets bigRiver to the String object “MISSISSIPPI”: 

When you apply a method to an object, you must make sure that the method is 
defined in the appropriate class. For example, it is an error to call 


System.out.lengthQ; // This method call is an error 


The PrintStream class (to which System. out belongs) has no length method. 

Let us summarize. In Java, every object belongs to a class. The class 
defines the methods for the objects. For example, the String class 
defines the length and toUpperCase methods (as well as other meth- 
ods—you will learn about most of them in Chapter 4). The methods 
form the public interface of the class, telling you what you can do 
with the objects of the class. A class also defines a private implemen- 
z tation, describing the data inside its objects and the instructions for 
its metho Those details are hidden from the programmers who use objects and 
call methods. 

Figure 4 shows two objects of the String class. Each object stores its own data 
(drawn as boxes that contain characters). Both objects support the same set of 
methods —the interface that is specified by the String class. 


SELF CHECK 


6. How can you compute the length of the string "Mississippi"? 
7. How can you print out the uppercase version of "Hello, World!"? 
8. Is it legal to call river.printInQ? Why or why not? 
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In this section, we will examine how to provide inputs into a method, and how to 
obtain the output of the method. 

Some methods require inputs that give details about the work that 
they need to do. For example, the printin method has an input: the 
string that should be printed. Computer scientists use the technical 
term parameter for method inputs. We say that the string greeting is 
a parameter of the method call 


System.out.printin(greeting) 


Figure 5 illustrates passing of the parameter to the method. 

Technically speaking, the greeting parameter is an explicit param- 
eter of the printin method. The object on which you invoke the 
method is also considered a parameter of the method call, called the 
implicit parameter. For example, System. out is the implicit parameter 


of the method call 


System.out.printIn(greeting) 


Some methods require multiple explicit parameters, others don’t require any 
explicit parameters at all. An example of the latter is the length method of the 
String class (see Figure 6). All the information that the length method requires to 
do its job—namely, the character sequence of the string—is stored in the implicit 
parameter object. 

The length method differs from the printin method in another 
way: it has an output. We say that the method returns a value, 
namely the number of characters in the string. You can store the 
return value in a variable: 


int n = greeting. lengthQ ; 


You can also use the return value as a parameter of another method: 


System.out.printIn(greeting. length()); 


"Hello, World" 


Figure 5 Passing a Parameter to the printIn Method 
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(no parameter) 13 


Figure 6 Invoking the length Method on a String Object 


The method call greeting.length(Q) returns a value—the integer 13. The return 
value becomes a parameter of the printIn method. Figure 7 shows the process. 

Not all methods return values. One example is the printIn method. The printin 
method interacts with the operating system, causing characters to appear in a win- 
dow. But it does not return a value to the code that calls it. 

Let us analyze a more complex method call. Here, we will call the replace 
method of the String class. The replace method carries out a search-and-replace 
operation, similar to that of a word processor. For example, the call 


river.replaceC"issipp", "“our") 


constructs a new string that is obtained by replacing all occurrences of "issipp" in 
"Mississippi" with "our". (In this situation, there was only one replacement.) The 
method returns the String object "Missouri" (which you can save in a variable or 
pass to another method). 

As Figure 8 shows, this method call has 
¢ one implicit parameter: the string "Mississippi" 
e two explicit parameters: the strings "issipp" and "our" 


e areturn value: the string "Missouri" 


(no parameter) 


Figure 7 Passing the Result of a Method Call to Another Method 
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"Tssipp" 
"Missouri" 


Figure 8 Calling the replace Method 


When a method is defined in a class, the definition specifies the types of the explicit 
parameters and the return value. For example, the String class defines the length 
method as 


public int lengthQ 


That is, there are no explicit parameters, and the return value has the type int. (For 
now, all the methods that we consider will be “public” methods—see Chapter 10 
for more restricted methods.) 
The type of the implicit parameter is the class that defines the method—String in 
our case. It is not mentioned in the method definition—hence the term “implicit”. 
The replace method is defined as 


public String replace(String target, String replacement) 


To call the replace method, you supply two explicit parameters, target and 
replacement, which both have type String. The returned value is another string. 

When a method returns no value, the return type is declared with the reserved 
word void. For example, the PrintStream class defines the printIn method as 


public void printIn(String output) 


Occasionally, a class defines two methods with the same name and 
different explicit parameter types. For example, the PrintStream class 
defines a second method, also called print1n, as 


public void printIn(int output) 


That method is used to print an integer value. We say that the print1n 
name is overloaded because it refers to more than one method. 


SELF CHECK 


9. What are the implicit parameters, explicit parameters, and return values in the 
method call river. length(Q) ? 


10. What is the result of the call river. replace("p", "s")? 
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11. What is the result of the call greeting. replace("World", "Dave").length(Q)? 
12. How is the toUpperCase method defined in the String class? 


Java has separate types for integers and floating-point numbers. Inte- 
gers are whole numbers; floating-point numbers can have fractional 
parts. For example, 13 is an integer and 1.3 is a floating-point 
ese number. 

The name “floating-point” describes the representation of the number in the 
computer as a sequence of the significant digits and an indication of the position of 
the decimal point. For example, the numbers 13000, 1.3, 0.00013 all have the same 
decimal digits: 13. When a floating-point number is multiplied or divided by 10, only 
the position of the decimal point changes; it “floats”. This representation 1s related to 
the “scientific” notation 1.3 x 10~. (Actually, the computer represents numbers in 
base 2, not base 10, but the principle is the same.) 

If you need to process numbers with a fractional part, you should use the type 
called double, which stands for “double precision floating-point number”. Think of 
a number in double format as any number that can appear in the display panel of a 
calculator, such as 1.3 or —0.333333333. 

Do not use commas when you write numbers in Java. For example, 13,000 must 
be written as 13000. To write numbers in exponential notation in Java, use the nota- 
tion En instead of “x10”. For example, 1.3x10~ is written as 1.3E-4. 

You may wonder why Java has separate integer and floating-point number types. 
Pocket calculators don’t need a separate integer type; they use floating-point num- 
bers for all calculations. However, integers have several advantages over floating- 
point numbers. They take less storage space, are processed faster, and don’t cause 
rounding errors. You will want to use the int type for quantities that can never have 
fractional parts, such as the length of a string. Use the double type for quantities that 
can have fractional parts, such as a grade point average. 

There are several other number types in Java that are not as commonly used. We 
will discuss these types in Chapter 4. For most practical purposes, however, the int 
and double types are all you need for processing numbers. 

. In Java, the number types (int, double, and the less commonly 
used types) are primitive types, not classes. Numbers are not objects. 
The number types have no methods. 

However, you can combine numbers with operators such as + and -, 
asin 10 + norn - 1. To multiply two numbers, use the * apemion 
For example, 10 X 7 is written as 10 * n. 

As in mathematics, the * operator “binds more strongly than the + 
operator. That is, x + y * 2 means the sum of x and y * 2. If you 
want to multiply the sum of x and y with 2, use parentheses: 


(x + y) * 2 


ae CHAPTER2 «# Using Objects 


SELF CHECK 


13. Which number type would you use for storing the area of a circle? 
14, Why is the expression 13.printInQ an error? 


15. Write an expression to compute the average of the values x and y. 


Most Java programs will want to work on a variety of objects. In this section, you 
will see how to construct new objects. This allows you to go beyond String objects 
and the predefined System. out object. 

To learn about object construction, let us turn to another class: the Rectangle 
class in the Java class library. Objects of type Rectangle describe rectangular 
shapes—see Figure 9. These objects are useful for a variety of purposes. You can 
assemble rectangles into bar charts, and you can program simple games by moving 
rectangles inside a window. 

Note that a Rectangle object isn’t a rectangular shape—it is an object that con- 
tains a set of numbers. The numbers describe the rectangle (see Figure 10). Each 
rectangle is described by the x- and y-coordinates of its top-left corner, its width, 
and its height. 


Figure 9 
Rectangular Shapes 


Figure 10 
Rectangle Objects 


Use the new 0 
followed bya 
and parameter 


construct new y objects. 
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It is very important that you understand this distinction. In the computer, a 
Rectangle object is a block of memory that holds four numbers, for example x = 5, 
y= 10, width = 20, height = 30. In the imagination of the programmer who uses a 
Rectangle object, the object describes a geometric figure. 

To make a new rectangle, you need to specify the x, y, width, and 
height values. Then invoke the new operator, specie the name of 
the class and the parameters that are required for constructing a new 
object. For example, you can make a new rectangle with its top-left 
corner at (5, 10), width 20, and height 30 as follows: 


new Rectangle(5, 10, 20, 30) 


perator, 
class name 


Here is what happens in detail. 


1. The new operator makes a Rectangle object. 


2. It uses the parameters (in this case, 5, 10, 20, and 30) to initialize the data of the 
object. 


3. It returns the object. 


Usually the output of the new operator is stored in a variable. For example, 
Rectangle box = new Rectangle(5, 10, 20, 30); 


The process of creating a new object is called construction. The four values 5, 10, 20, 
and 30 are called the construction parameters. Note that the new expression is not a 
complete statement. You use the value of a new expression just like a method return 
value: Assign it to a variable or pass it to another method. 

Some classes let you construct objects in multiple ways. For example, you can also 
obtain a Rectangle object by supplying no construction parameters at all (but you 
must still supply the parentheses): 


new Rectangle() 


This expression constructs a (rather useless) rectangle with its top-left corner at the 
origin (0, 0), width 0, and height 0. 


SYNTAX 2.3 Object Construction 


new ClassName (parameters) 


Example: 

new Rectangle(5, 10, 20, 30) 
new Rectangle() 

Purpose: 


To construct a new object, initialize it with the construction parameters, and return a 
reference to the constructed object 
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SELF CHECK 


16. How do you construct a square with center (100, 100) and side length 20? 
17. What does the following statement print? 
System.out.printIn(new Rectangle().getWidthQ)); 


COMMON ERROR 2.1 


Trying to Invoke a Constructor Like a Method 


Constructors are not methods. You can only use a constructor with the new operator, not to 
reinitialize an existing object: 


box.Rectangle(20, 35, 20, 30); // Error—can’t reinitialize object 
The remedy is simple: Make a new object and overwrite the current one. 


box = new Rectangle(20, 35, 20, 30); // OK 


In this section we introduce a useful terminology for the methods of 
a class. A method that accesses an object and returns some informa- 
tion about it, without changing the object, is called an accessor 
method. In contrast, a method whose purpose is to modify the state 
of an object is called a mutator method. 

For example, the length method of the String class is an accessor 
method. It returns information about a string, namely its length. But 
it doesn’t modify the string at all when counting the characters. 

The Rectangle class has a number of accessor methods. The getX, getY, getWidth, 
and getHeight methods return the x- and y-coordinates of the top-left corner, the 
width, and the height values. For example, 


double width = box.getWidthQ) ; 


Now let us consider a mutator method. Programs that manipulate rectangles fre- 
quently need to move them around, for example, to display animations. The 
Rectangle class has a method for that purpose, called translate. (Mathematicians 
use the term “translation” for a rigid motion of the plane.) This method moves a 
rectangle by a certain distance in the x- and y-directions. The method call, 


box.translate(15, 25); 


moves the rectangle by 15 units in the x-direction and 25 units in the y-direction 
(see Figure 11). Moving a rectangle doesn’t change its width or height, but it 
changes the top-left corner. Afterwards, the top-left corner is at (20, 35). 

This method is a mutator because it modifies the implicit parameter object. 
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Figure 11 
Using the translate Method to Move a Rectangle 


SELF CHECK 


18. Is the toUpperCase method of the String class an accessor or a mutator? 


19. Which call to translate is needed to move the box rectangle so that its top-left 
corner is the origin (0, 0)? 


In this section, we discuss the steps that are necessary to implement a test program. 
The purpose of a test program is to verify that one or more methods have been 
implemented correctly. A test program calls methods and checks that they return 
the expected results. Writing test programs is a very important activity. When you 
implement your own methods, you should always supply programs to test them. 

In this book, we use a very simple format for test programs. You will now see 
such a test program that tests a method in the Rectangle class. The program per- 
forms the following steps: 


1. Provide a tester class. 

2. Supply a main method. 

3. Inside the main method, construct one or more objects. 

4. Apply methods to the objects. 

5. Display the results of the method calls. 

6. Display the values that you expect to get. 
Whenever you write a program to test your own classes, you need to follow these 
steps as well. 

Our sample test program tests the behavior of the translate method. Here are 


the key steps (which have been placed inside the main method of the Rectangle- 
Tester class). 
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Rectangle box = new Rectangle(5, 10, 20, 30); 


// Move the rectangle 
box.translate(15, 25); 


// Print information about the moved rectangle 
System.out.printC"x: "); 
System.out.printIn(box.getx()) ; 
System.out.printInC"Expected: 20"); 


TESTING TRACK 


We print the value that is returned by the getX method, and then we print a message 
that describes what value we expect to see. 


"Determining the expected : 
result in advance is ar . 
important part of. testing. 


This is a very important step. You want to spend some time think- 
ing what the expected result is before you run a test program. This 
thought process will help you understand how your program should 


behave, and it can help you track down errors at an early stage. 
In our case, the rectangle has been constructed with the top left corner at (5, 10). 
The x-direction is moved by 15 pixels, so we expect an x-value of 5 + 15 = 20 after 
the move. 


Here is a complete program that tests the moving of a rectangle. 


ch02/rectangle/Movetester.java 


; import java.awt.Rectangle; 
3 public class MoveTester 
4 
5 public static void main(String[] args) 
6 { 
: Rectangle box = new Rectangle(®, !9, 20, 
9 // Move the rectangle 
“4 box.translate(i5, 25); 
12 // Print information about the moved rectangle 
13 System.out.print('x: "); 
14 System.out.printIn(box.getX()); 
15 System.out.printIn("Expected: 20"); 
16 
17 System.out.print('y: "); 
18 System.out.printIn(box.getYQ); 
19 System.out.printIn('Expected: 35"); 
20 
21 3 
Output 
x: 20 
Expected: 20 
y: 35 


Expected: 35 
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OES are grouped For this program, we needed to carry out another step: We needed to 
into packages. Usethe port the Rectangle class from a package. A package is a collection 
“import statement touse Of Classes with a related purpose. All classes in the standard library 
classes that are defined in are contained in packages. The Rectangle class belongs to the package 
other packages. java.awt (where awt is an abbreviation for “Abstract Windowing 
Toolkit”), which contains many classes for drawing windows and 

graphical shapes. 


To use the Rectangle class from the java. awt package, simply place the following 
line at the top of your program: 


import java.awt.Rectangle; 


Why don’t you have to import the System and String classes? Because the System 
and String classes are in the java. lang package, and all classes from this package are 
automatically imported, so you never need to import them yourself. 


SYNTAX 2.4 Importing a Class from a Package 


import packageName.ClassName; 


Example: 


import java.awt.Rectangle; 


Purpose: 


To import a class from a package for use in a program 


SELF CHECK 


20. Suppose we had called box.translate(25, 15) instead of box.translate(15, 25). 
What are the expected outputs? 


21. Why doesn’t the MoveTester program need to print the width and height of the 
rectangle? 


22. The Random class is defined in the java.util package. What do you need to do in 
order to use that class in your program? 


ADVANCED TOPIC 2.1 


Testing Classes in an Interactive Environment 


Some development environments are specifically designed to help students explore objects 
without having to provide tester classes. These environments can be very helpful for gaining 
insight into the behavior of objects, and for promoting object-oriented thinking. The Blue] 
environment (shown in Testing a Method Call in BlueJ) displays objects as blobs on a work- 
bench. You can construct new objects, put them on the workbench, invoke methods, and see 
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the return values, all without writing a line of code. You can download Blue] at no charge 
from [1]. Another excellent environment for interactively exploring objects is Dr. Java [2]. 


‘Project Edit Tools View 
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Testing a Method Call in BlueJ 


The classes and methods of the Java library are listed in the API documentation. 
The API is the “application programming interface”. A programmer who uses the 
Java classes to put together a computer program (or application) is an application 
programmer. That’s you. In contrast, the programmers who designed and imple- 
mented the library classes such as PrintStream and Rectangle are system 
programmers. 
é oe You can find the API documentation on the Web [3]. Point your 
ae API (Application = ae 
Programming Interface ce web browser to http://java.sun. com/j avase/6/docs/api/1 ndex. html. 
a ean Alternatively, you can download and install the API documentation 
onto your own computer—see Productivity Hint 2.1. 

The API documentation documents all classes in the Java library — 
rl there are thousands of them (see Figure 12). Most of the classes are 

aie specialized, and only a few are of interest to the beginning programmer. 
Locate the Rectangle link in the left pane, preferably by using the search function 
of your browser. Click on the link, and the right pane shows all the features of the 


Rectangle class (see Figure 13). 


2.9 8s The API Documentation 
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Figure 13. The API Documentation for the Rectangle Class 


The API documentation for each class starts out with a section that describes the 
purpose of the class. Then come summary tables for the constructors and methods (see 
Figure 14). Click on the link of a method to get a detailed description (see Figure 15). 

As you can see, the Rectangle class has quite a few methods. While occasionally 
intimidating for the beginning programmer, this is a strength of the standard library. 
If you ever need to do a computation involving rectangles, chances are that there is 


a method that does all the work for you. 
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Figure 15 The API Documentation of the translate Method 


Appendix C contains an abbreviated version of the API documentation. You 
may find the abbreviated documentation easier to use than the full documentation. 
It is fae if you rely on the abbreviated documentation for your first programs, but 
you should eventually move on to the real thing. 
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SELF CHECK 


23. Look at the API documentation of the String class. Which method would you 
use to obtain the string "hello, world!" from the string "Hello, World!"? 


24. In the API documentation of the String class, look at the description of the 
trim method. What is the result of applying trim to the string" Hello, Space | "? 
(Note the spaces in the string.) 


PRODUCTIVITY HINT 2.1 


Don’t Memorize—Use Online Help 


The Java library has thousands of classes and methods. It is neither necessary nor useful try- 
ing to memorize them. Instead, you should become familiar with using the API documenta- 
tion. Since you will need to use the API documentation all the time, it is best to download 
and install it onto your computer, particularly if your computer is not always connected to 
the Internet. You can download the documentation from http://java.sun.com/javase/ 
downloads/index.htm1. 


In Java, a variable whose type is a class does not actually hold an object. It merely 
holds the memory location of an object. The object itself is stored elsewhere—see 
Figure 16. 

| a We use the technical term object reference to denote the memory 
location of an object. When a variable contains the memory location 
of an object, we say that it refers to an object. For example, after the 
statement 


| An object reference 6 
describes the location of _ 


Rectangle box = new Rectangle(5, 10, 20, 30); 


box. = 


Figure 16 An Object Variable Containing an Object Reference 
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Figure 17 Two Object Variables Referring to the Same Object 


Figure 18 A Number Variable Stores a Number 


the variable box refers to the Rectangle object that the new operator constructed. 
Technically speaking, the new operator returned a reference to the new object, and 
that reference is stored in the box variable. 

It is very important that you remember that the box variable does not contain the 
object. It refers to the object. You can have two object variables refer to the same 
object: 


Rectangle box2 = box; 


Now you can access the same Rectangle object both as box and as 
box2, as shown in Figure 17. 
However, number variables actually store numbers. When you 


define 
int luckyNumber = 13; 


then the luckyNumber variable holds the number 13, not a reference to the number 
(see Figure 18). 

You can see the difference between number variables and object 
variables when you make a copy of a variable. When you copy a 
primitive type value, the original and the copy of the number are 
independent values. But when you copy an object reference, both the 
original and the copy are references to the same object. 

Consider the following code, which copies a number and then changes the copy 
(see Figure 19): 


int luckyNumber = 13; 
int JuckyNumber2 = luckyNumber; 2 
TuckyNumber2 = 12; © 


Now the variable luckyNumber contains the value 13, and luckyNumber2 contains 12. 
Now consider the seemingly analogous code with Rectangle objects. 
Rectangle box = new Rectangle(5, 10, 20, 30); ap 


Rectangle box2 = box; // See Figure 20 @ 
box2.translate(15, 25); @ 
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Figure 19 
Copying Numbers 


Since box and box2 refer to the same rectangle after step @, both variables refer to 
the moved rectangle after the call to the translate method. 


Figure 20 Copying Object References 
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There is a reason for the difference between numbers and objects. In the com- 
puter, each number requires a small amount of memory. But objects can be very 
large. It is far more efficient to manipulate only the memory location. 

Frankly speaking, most programmers don’t worry too much about the difference 
between objects and object references. Much of the time, you will have the correct 
intuition when you think of “the object box” rather than the technically more accu- 
rate “the object reference stored in box”. The difference between objects and object 
references only becomes apparent when you have multiple variables that refer to 
the same object. 


SELF CHECK 


25. What is the effect of the assignment greeting2 = greeting? 


26. After calling greeting2.toUpperCase(), what are the contents of greeting and 
greeting2? 


RANDOM FACT 2.1 


Mainframes—When Dinosaurs Ruled the Earth 


When International Business Machines Corporation (IBM), a successful manufacturer of 
punched-card equipment for tabulating data, first turned its attention to designing comput- 
ers in the early 1950s, its planners assumed that there was a market for perhaps 50 such 
devices, for installation by the government, the military, and a few of the country’s largest 
corporations. Instead, they sold about 1,500 machines of their System 650 model and went 
on to build and sell more powerful computers. 

The so-called mainframe computers of the 1950s, 1960s, and 1970s were huge. They filled 
rooms, which had to be climate-controlled to protect the delicate equipment (see A Main- 
frame Computer). Today, because of miniaturization technology, even mainframes are get- 
ting smaller, but they are still very expensive. (At the time of this writing, the cost for a 
typical mainframe is several million dollars.) 

These huge and expensive systems were an immediate success when they first appeared, 
because they replaced many roomfuls of even more expensive employees, who had previ- 
ously performed the tasks by hand. Few of these computers do any exciting computations. 
They keep mundane information, such as billing records or airline reservations; they just 
keep lots of them. 

IBM was not the first company to build mainframe computers; that honor belongs to the 
Univac Corporation. However, IBM soon became the major player, partially because of 
technical excellence and attention to customer needs and partially because it exploited its 
strengths and structured its products and services in a way that made it difficult for custom- 
ers to mix them with those of other vendors. In the 1960s, IBM’s competitors, the so-called 
“Seven Dwarfs”— GE, RCA, Univac, Honeywell, Burroughs, Control Data, and NCR —fell 
on hard times. Some went out of the computer business altogether, while others tried unsuc- 
cessfully to combine their strengths by merging their computer operations. It was generally 
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predicted that they would eventually all fail. It was in this atmosphere that the U.S. govern- 
ment brought an antitrust suit against IBM in 1969. The suit went to trial in 1975 and 
dragged on until 1982, when the Reagan Administration abandoned it, declaring it “without 
merit”. 

Of course, by then the computing landscape had changed completely. Just as the dino- 
saurs gave way to smaller, nimbler creatures, three new waves of computers had appeared: 
the minicomputers, workstations, and microcomputers, all engineered by new companies, 
not the Seven Dwarfs. Today, the importance of mainframes in the marketplace has dimin- 
ished, and IBM, while still a large and resourceful company, no longer dominates the com- 
puter market. 

Mainframes are still in use today for two reasons. They still excel at handling large data 
volumes. More importantly, the programs that control the business data have been refined 
over the last 30 or more years, fixing one problem at a time. Moving these programs to less 
expensive computers, with different languages and operating systems, is difficult and 
error-prone. In the 1990s, Sun Microsystems, a leading manufacturer of workstations and 
servers—and the inventor of Java—was eager to prove that its mainframe system could be 
“downsized” and replaced by its own equipment. Sun eventually succeeded, but it took over 
five years—far longer than it expected. 
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_. 
This is the first of several sections that teach you how to write graphical applica- 
tions: applications that display drawings inside a window. Graphical applications 
look more attractive than the console applications that show plain text in a console 
window. 

The material in this section, as well as the sections labeled “Graphics Track” in 
other chapters, are entirely optional. Feel free to skip them if you are not interested 
in drawing graphics. 

A graphical application shows information inside a frame win- 

~ dow: a window with a title bar, as shown in Figure 21. In this section, 

pia. YOu will learn how to display a frame window. In Section 3.9, you 
~~ -will learn how to create a drawing inside the frame. 

To show a frame, carry out the following steps: 


1. Construct an object of the JFrame class: 
JFrame frame = new JFrame(); 
2. Set the size of the frame 


frame.setSize(300, 400); 


This frame will be 300 pixels wide and 400 pixels tall. If you omit this step the 
frame will be 0 by 0 pixels, and you won’t be able to see it. 


3. If you’d like, set the title of the frame. 
frame.setTitleC"An Empty Frame"); 
If you omit this step, the title bar is simply left blank. 
4. Set the “default close operation”: 
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 


Figure 21. A Frame Window 
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When the user closes the frame, the program automatically exits. Don’t omit 
this step. If you do, the program continues running even after the frame is 
closed. 


5. Make the frame visible. 


frame.setVisible(true) ; 


The simple program below shows all of these steps. It produces the empty frame 
shown in Figure 21 

The JFrame class is a part of the javax.swing package. Swing is the nickname for 
the graphical user interface library in Java. The “x” in javax denotes the fact that 
Swing started out as a Java extension before it was added to the standard library. 

We will go into much greater detail about Swing programming in Chapters 3, 9, 
10, and 18. For now, consider this program to be the essential plumbing that is 
required to show a frame. 


ch02/emptyframe/EmptyFrameViewer.java 


import javax.swing.JFrame 


3 public class EmptyFrameViewer 


4 { 
5 public static void main(String[] args 
6 
i JFrame frame = new JFrame() 
8 
frame.setSize(300, 400); 
10 frame.setTitle("An Empty Frame"); 
11 frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) 
12 
13 frame.setVisible(true) 
14 
15} 
SELF CHECK 


27. How do you display a square frame with a title bar that reads “Hello, World!”? 


28. How can a program display two frames at once? 


This section continues the optional graphics track. You will learn how to make 
shapes appear inside a frame window. The first drawing will be exceedingly modest: 
just two rectangles (see Figure 22). You’ll soon see how to produce more interesting 
drawings. The purpose of this example is to show you the basic outline of a pro- 
gram that creates a drawing. You cannot draw directly onto a frame. Whenever you 
want to show anything inside a frame, be it a button or a drawing, you have to 
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construct a component object and add it to the frame. In the Swing toolkit, the JCom- 
ponent class represents a blank component. 


In order to display a 
drawing ina frame, define 
a class that extends the 
jJComponent class. 


Since we don’t want to add a blank component, we have to modify 
the JComponent class and specify how the component should be 
painted. The solution is to define a new class that extends the 
JComponent class. You will learn about the process of extending 
classes in Chapter 10. For now, simply use the following code as a 
template. 


public class RectangleComponent extends JComponent 


{ 


public void paintComponent(Graphics g) 


{ 


Drawing instructions go here 


} 


Place drawing 
instructions inside the _ 
paintComponent method. 
That method is called 
whenever the component 
needs to be repainted. 


The Graphics class lets 


you manipulate the 


graphics state (such as the © 


current color). 


The extends keyword indicates that our component class, 
Rectang leComponent, inherits the methods of JComponent. However, 
the RectangleComponent is different from the plain JComponent in one 
respect: The paintComponent method will contain instructions to 
draw the rectangles. 

When the window is shown for the first time, the paintComponent 
method is called automatically. The method is also called when the 
window is resized, or when it is shown again after it was hidden. 

The paintComponent method receives an object of type Graphics. 
The Graphics object stores the graphics state—the current color, font, 
and so on, that are used for drawing operations. 

However, the Graphics class is primitive. When programmers 
clamored for a more object-oriented approach for drawing graphics, 
the designers of Java created the Graphics2D class, which extends the 
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Graphics class. Whenever the Swing toolkit calls the paintComponent 
method, it actually passes a parameter of type Graphics2D. Programs 
with simple graphics do not need this feature. Because we want to 
use the more sophisticated methods to draw two-dimensional 
graphics objects, we need to recover the Graphics2D. This is accom- 
plished by using a cast: 


public class RectangleComponent extends JComponent 


{ 
public void paintComponent(Graphics g) 


{ 


// Recover Graphics2D 
Graphics2D g2 = (Graphics2D) g; 


} 


Now you are ready to draw shapes. The draw method of the Graphics2D class can 
draw shapes, such as rectangles, ellipses, line segments, polygons, and arcs. Here we 
draw a rectangle: 


public class RectangleComponent extends JComponent 


{ 
public void paintComponent(Graphics g) 
1 
Rectangle box = new Rectangle(5, 10, 20, 30); 
g2.draw(box) ; 
} 
} 


Following is the source code for the RectangleComponent class. Note that the 
paintComponent method of the Rectang leComponent class draws two rectangles. 

As you can see from the import statements, the Graphics and Graphics2D classes 
are part of the java.awt package. 


ch02/rectangles/RectangleComponent.java 


1 import java.awt.Graphics; 

2 import java.awt.Graphics2D; 

3 import java.awt.Rectangle; 

4 import javax.swing.JComponent; 

5 

6 / n% 

7 A component that draws two rectangles. 

8 * 7 

9 public class RectangleComponent extends JComponent 
10 { 
11 public void paintComponent(Graphics g) 
12 f 
i3 // Recover Graphics2D 
14 Graphics2D g2 = (Graphics2D) g; 
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16 // Construct a rectangle and draw it 

17 Rectangle box = new Rectangle(5, 20, 20, 30); 
18 g2.draw(box) ; 

19 

20 // Move rectangle 15 units to the right and 25 units down 
21 box.translate(15, 25); 

22 

23 // Draw moved rectangle 

24 g2.draw(box) ; 

23 } 

26 } 


In order to see the drawing, one task remains. You need to display the frame into 
which you added a component object. Follow these steps: 
1. Construct a frame as described in the preceding section. 
2. Construct an object of your component class: 
RectangleComponent component = new RectangleComponent() ; 
3. Add the component to the frame: 
frame.add(Ccomponent) ; 


4. Make the frame visible, as described in the preceding section. 


The following listing shows the complete process. 


ch02/rectangles/RectangleViewer.java 


L import javax.swing.JFrame; 
2 
3 public class RectangleViewer 
4 f{ 
5 public static void main(String[] args) 
6 { 
7 JFrame frame = new JFrame(); 
8 frame.setSize(300, 400); 
i frame.setTitle("Two rectangles"); 
10 frame.setDefaultCloseOperation(jJFrame.EXIT_ON_CLOSE) ; 
11 
12 RectangleComponent component = new RectangleComponent() ; 
13 frame.add(component) ; 
14 
15 frame.setVisible(true); 
16} 
17 } 


Note that the rectangle drawing program consists of two classes: 


e The Rectang leComponent class, whose paintComponent method produces the 
drawing 


e The RectangleViewer class, whose main method constructs a frame and a 
RectangleComponent, adds the component to the frame, and makes the frame 
visible 
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SELF CHECK 


29. How do you modity the program to draw two squares? 
30. How do you modify the program to draw one rectangle and one square? 


31. What happens if you call g.draw(box) instead of g2.draw(box) ? 


ADVANCED TOPIC 2.2 


In the preceding section, you learned how to write a program 
that displays graphical shapes. Some people preter to use 
applets for learning about graphics programming. Applets 
have two advantages. They don’t need separate component 
and viewer classes; you only implement a single class. And, more importantly, applets run 
inside a web browser, allowing you to place your creations on a web page for all the world to 
admire. 
To implement an applet, use this code outline: 


public class MyApplet extends JApplet 


{ 
public void paint(Graphics g) 
{ 
// Recover Graphics2D 
Graphics2D g2 = (Graphics2D) g; 
// Drawing instructions go here 
} 
} 


This is almost the same outline as for a component, with two minor differences: 


1. You extend JApplet, not JComponent. 
2. You place the drawing code inside the paint method, not inside paintComponent. 


The following applet draws two rectangles: 


ch02/applet/RectangleApplet.java 


l import java.awt.Graphics; 

2 import java.awt.Graphics2D; 

3 import java.awt.Rectangle; 

4 import javax.swing.JApplet; 

5 

6 pias 

7 An applet that draws two rectangles. 
8 + 

9 public class RectangleApplet extends JApplet 
10 { 
ll public void paint(Graphics g) 


12 { 
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13 // Prepare for extended graphics 

14 Graphics2D g2 = (Graphics2D) g; 

15 

16 // Construct a rectangle and draw it 

17 Rectangle box = new Rectangle(5, 10, 20, 30); 

18 g2.draw(box) ; 

19 

20 // Move rectangle 15 units to the right and 25 units down 
pai box.translate(15, 25); 

Ze 

23 // Draw moved rectangle 

24 g2.draw(box); 

25 ; 

26 } 


uae pk eee To run this applet, you need an HTML file with an applet 

a HTML file with th 2 tag. HTML, the hypertext markup language, is the language 

applet tag. ~ used to describe web pages. (See Appendix H for more infor- 

a rtrtéi‘“—Cs~sSO mation on HTML.) Here is the simplest possible file to dis- 
play the rectangle applet: 


ch02/applet/RectangleApplet.html 


1 <applet code="RectangleApplet.class" width="300" height="400"> 
2 </applet> 


If you know HTML, you can proudly explain your creation, by adding text and more 
HTML tags: 


ch02/applet/RectangleAppletExplained.html 


<html> 
<head> 
<title>Two rectangles</title> 
</head> 
<body> 
<p>Here is my <i>first applet</i>:</p> 
<applet code="RectangleApplet.class" width="300" height="400"> 
</applet> 
</body> 
10) </htmi> 


WOnauwtpwn-e 


An HTML file can have multiple applets. Simply add a separate applet tag for each applet. 

You can give the HTML file any name you like. It is easiest to give the HTML file the 
same name as the applet. But some development environments already generate an HTML 
file with the same name as your project to hold your project notes; then you must give the 
HTML file containing your applet a different name. 

To run the applet, you have two choices. You can use the applet viewer, a program that is 
included with the Java Software Development Kit from Sun Microsystems. You simply start 
the applet viewer, giving it the name of the HTML file that contains your applets: 


appletviewer RectangleApplet.htm] 
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Here is my first applet: 


Applet started 


An Applet in the Applet Viewer An Applet in a Web Browser 


The applet viewer only shows the applet, not the HTML text 
(see An Applet in the Applet Viewer). 

You can also show the applet inside any Java 2-enabled 
web browser, such as Netscape or Mozilla. (If you use Inter- 
net Explorer, you probably need to configure it. By default, 
Microsoft supplies either an outdated version of Java or no Java at all. Go to the web site [4] 
and install the Java plugin.) An Applet in a Web Browser shows the applet running in a 
browser. As you can see, both the text and the applet are displayed. 


Ellipses, Lines, Text, and Colc 


In Section 2.12 you learned how to write a program that draws rectangles. In this 
section you will learn how to draw other shapes: ellipses and lines. With these 
graphical elements, you can draw quite a few interesting pictures. 

To draw an ellipse, you specify its bounding box (see Figure 23) in the same way 
that you would specify a rectangle, namely by the x- and y-coordinates of the top- 
left corner and the width and height of the box. 

However, there is no simple E11ipse class that you can use. Instead, you must use 
one of the two classes Ellipse2D.Float and Ellipse2D.Double, depending on 
whether you want to store the ellipse coordinates as single- or double-precision 
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Width 


Height 


Figure 23 An Ellipse and Its Bounding Box 


floating-point values. Because the latter are more convenient to use in Java, we will 
always use the E1lipse2D.Double class. Here is how you construct an ellipse: 


Ellipse2D.Double ellipse = new Ellipse2D.Double(x, y, width, height); 


Eilipse2D Double andi The class name E1lipse2D.Doub1e looks ditterent from the class names 
Line2D.Double are classes that you have encountered up to now. It consists of two class names 
that describe graphical Ell ipse2D and Double separated by a period (.). This indicates that 
shapes. - Ellipse2D.Double is a so-called inner class inside Ellipse2D. When 


constructing and using ellipses, you don’t actually need to worry about 
the fact that E11ipse2D.Double is an inner class—just think of it as a class with a long 
name. However, in the import statement at the top of your program, you must be 
careful that you import only the outer class: 


Import java.awt.geom.E1lipse2D; 


Drawing an ellipse is easy: Use exactly the same draw method of the Graphics2D class 
that you used for drawing rectangles. 


g2.draw(ellipse); 
To draw a circle, simply set the width and height to the same values: 


Ellipse2D.Double circle = new Ellipse2D.Double(x, y, diameter, diameter); 
g2.draw(circle); 


Baseline 


Basepoint 


Figure 24 Basepoint and Baseline 
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Notice that (x, y) is the top-left corner of the bounding box, not the center of the 
circle. 

To draw a line, use an object of the Line2D.Double class. A line is constructed by 
specifying its two end points. You can do this in two ways. Simply give the x- and 
y-coordinates of both end points: 


Line2D.Double segment = new Line2D.Double(xl1, yl, x2, y2); 
Or specify each end point as an object of the Point2D.Double class: 


Point2D.Double from = new Point2D.Double(xl, yl); 
Point2D.Double to = new Point2D.Double(x2, y2); 


Line2D.Double segment = new Line2D.Double(from, to); 


The second option is more object-oriented and is often more useful, particularly if 
the pombe objects can be reused elsewhere in the same drawing. 

You often want to put text inside a drawing, for example, to label 
some of the parts. Use the drawString method of the Graphics2D class 
to draw a string anywhere in a window. You must specify the string 
and the x- and y-coordinates of the basepoint of the first character in 
the string (see Figure 24). For example, 


“its ‘basep Int. 2 


g2.drawString("Message", 50, 100); 


When you first start drawing, all shapes and strings are drawn with a black pen. To 
change the color, you need to supply an object of type Color. Java uses the RGB 
color model. That is, you specify a color * the amounts of the primary colors— 
red, green, and blue—that make up the color. The amounts are given as integers 
between 0 (primary color not present) and 255 (maximum amount present). For 
example, 


Color magenta = new Color(255, 0, 255); 


constructs a Color object with maximum red, no green, and maximum blue, yielding 
a bright purple color called magenta. 
r For your convenience, a variety of colors have been predefined in 
“When oOM Seb 8 OE color the Color class. Table 1 shows those predefined colors and their RGB 
a“ the graphics context, it values. For example, Color.PINK has been predefined to be the same 
_is used for subsequent _ | 
drawing operations. os color as new Color(255, 175, 175). 
: To draw a rectangle in a different color, first set the color of the 
Graphics2D object, then call the draw method: 


g2.setColor(Color.RED) ; 
g2.draw(circle); // draws the shape in red 


If you want to color the inside of the shape, use the F111 method instead of the draw 
method. For example, 


g2.fillCcircle); 


fills the inside of the circle with the current color. 
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Table 1 Predefined Colors and Their RGB Values 


Color RGB Value 
Color.BLACK 0, .0,.0 
Color.BLUE 0,0, 255 
Color.CYAN ESR aes ee 
Color.GRAY 128, 128, 128 

Color .DARKGRAY 64, 64, 64 
Color.LIGHTGRAY 192, 192,192 
Color.GREEN 0,--255,° 0 
Color.MAGENTA goon 0, 255 
Color .ORANGE 255, 200, 0 

Color. PINK 255, 475, 175 
Color.RED eso gy 0 
Color.WHITE 299, 295, 255 
Color. YELLOW Zon; 255, 0 


The following program puts all these shapes to work, creating a simple drawing 
(see Figure 25). 


ff. An Alien Face 


Hello, World! 


Figure 25 An Alien Face 
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ch02/faceviewer/FaceComponent.java 


1 import java.awt.Color; 

2 import java.awt.Graphics; 

3 import java.awt.Graphics2D; 

4 import java.awt.Rectangle; 

5 ~=import java.awt.geom.E1lipse2D; 
6 import java.awt.geom.Line2D; 

7 import javax.swing. JPanel; 

: import javax.swing.JComponent; 


10 Vika 
ii A component that draws an alien face. 
12 * / 
i. public class FaceComponent extends JComponent 

t 
- public void paintComponent(Graphics g) 

{ 

ii // Recover Graphics2D 
(3 Graphics2D g2 = (Graphics2D) g; 
20 // Draw the head 
21 Ellipse2D.Double head = new Ellipse2D.Double(5, 10, 100, 150); 
22 g2.draw(head) ; 
23 
24 // Draw the eyes 
25 Line2D.Double eyel = new Line2D.Double(25, 70, 45, 90); 
26 g2.draw(eyel) ; 
27 
28 Line2D.Double eye2 = new Line2D.Double(85, 70, 65, 90); 
29 g2.draw(eye2); 
30 
31 // Draw the mouth 
32 Rectangle mouth = new Rectangle(30, 130, 50, 5); 
33 g2.setColor(Color.RED) ; 
34 g2.fi11 (mouth) ; 
35 
36 // Draw the greeting 
37 g2.setColor(Color.BLUE) ; 
38 g2.drawStringC("Hello, World!", 5, 175); 
39 
40 } 


ch02/faceviewer/FaceViewer.java 


1 import javax.swing.JFrame; 

2 

3 public class FaceViewer 

4 { 

5 public static void main(String[] args) 

6 { 

rs JFrame frame = new JFrame(); 

8 frame.setSize(300, 400); 

9 frame.setTitle("An Alien Face"); 
10 frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
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11 

12 FaceComponent component = new FaceComponent(); 
13 frame.add(component) ; 

14 

15 frame.setVisible(true); 

16 } 

17 } 


SELF CHECK 


32. Give instructions to draw a circle with center (100, 100) and radius 25. 
33. Give instructions to draw a letter “V” by drawing two line segments. 
34. Give instructions to draw a string consisting of the letter “V”. 

35. What are the RGB color values of Color.BLUE? 

36. How do you draw a yellow square on a red background? 


RANDOM FACT 2.2 


The Evolution of the Internet 


In 1962, J.C.R. Licklider was head of the first computer research program at DARPA, the 
Defense Advanced Research Projects Agency. He wrote a series of papers describing a 
“galactic network” through which computer users could access data and programs from 
other sites. This was well before computer networks were invented. By 1969, four 
computers—three in California and one in Utah—were connected to the ARPANET, the 
precursor of the Internet. The network grew quickly, linking computers at many universities 
and research organizations. It was originally thought that most network users wanted to run 
programs on remote computers. Using remote execution, a researcher at one institution 
would be able to access an underutilized computer at a different site. It quickly became 
apparent that remote execution was not what the network was actually used for. Instead, the 
“killer application” was electronic mail: the transfer of messages between computer users at 
different locations. 

In 1972, Bob Kahn proposed to extend ARPANET into the Jnternet: a collection of 
interoperable networks. All networks on the Internet share common protocols for data 
transmission. Kahn and Vinton Cerf developed protocols, now called TCP/IP (Transmission 
Control Protocol/Internet Protocol). On January 1, 1983, all hosts on the Internet simulta- 
neously switched to the TCP/IP protocol (which is used to this day). 

Over time, researchers, computer scientists, and hobbyists published increasing amounts 
of information on the Internet. For example, the GNU (GNU’s Not UNIX) project is pro- 
ducing a free set of high-quality operating system utilities and program development tools 
[5]. Project Gutenberg makes available the text of important classical books, whose copy- 
right has expired, in computer-readable form [6]. In 1989, Tim Berners-Lee started work on 
hyperlinked documents, allowing users to browse by following links to related documents. 
This infrastructure is now known as the World Wide Web (WWW). 

The first interfaces to retrieve this information were, by today’s standards, unbelievably 
clumsy and hard to use. In March 1993, WWW traffic was 0.1% of all Internet traffic. All 
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that changed when Marc Andreesen, then a graduate student working for NCSA (the 
National Center for Supercomputing Applications), released Mosaic. Mosaic displayed web 
pages in graphical form, using images, fonts, and colors (see The NCSA Mosaic Browser fig- 
ure). Andreesen went on to fame and fortune at Netscape, and Microsoft licensed the Mosaic 
code to create Internet Explorer. By 1996, WWW traffic accounted for more than half of the 
data transported on the Internet. 


= “NCSA Mosaic - Virginia Tech ‘Chemistry Hypermedia. 7 r+? 
eee Navigate Annotate chemist News/http Starting Pts Help 


The NCSA Mosaic Browser 


CHAPTER SUMMARY 


1. In Java, every value has a type. 
2. You use variables to store values that you want to use at a later time. 


3. Identifiers for variables, methods, and classes are composed of letters, digits, and 
underscore characters. 


4. By convention, variable names should start with a lowercase letter. 
5. Use the assignment operator (=) to change the value of a variable. 
6. All variables must be initialized before you access them. 


7. Objects are entities in your program that you manipulate by calling methods. 
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13. 
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17. 
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A method is a sequence of instructions that accesses the data of an object. 


A class defines the methods that you can apply to its objects. 


. The public interface of a class specifies what you can do with its objects. The 


hidden implementation describes how these actions are carried out. 


. A parameter is an input to a method. 


. The implicit parameter of a method call is the object on which the method is 


invoked. 


The return value of a method is a result that the method has computed for use 
by the code that called it. 


A method name is overloaded if a class has more than one method with the 
same name (but different parameter types). 


The double type denotes floating-point numbers that can have fractional parts. 
In Java, numbers are not objects and number types are not classes. 
Numbers can be combined by arithmetic operators such as +, -, and *. 


Use the new operator, followed by a class name and parameters, to construct 
new objects. 


An accessor method does not change the state of its implicit parameter. A 
mutator method changes the state. 


Determining the expected result in advance is an important part of testing. 


Java classes are grouped into packages. Use the import statement to use classes 
that are defined in other packages. 


The API (Application Programming Interface) documentation lists the classes 
and methods of the Java library. 


An object reference describes the location of an object. 

Multiple object variables can contain references to the same object. 
Number variables store numbers. Object variables store references. 

To show a frame, construct a JFrame object, set its size, and make it visible. 


In order to display a drawing in a frame, define a class that extends the 
JComponent class. 


Place drawing instructions inside the paintComponent method. That method is 
called whenever the component needs to be repainted. 


The Graphics class lets you manipulate the graphics state (such as the current 
color). 


The Graphics2D class has methods to draw shape objects. 
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31. Use a cast to recover the Graphics2D object from the Graphics parameter of the 
paintComponent method. 


32. Applets are programs that run inside a web browser. 


33. To run an applet, you need an HTML file with the applet tag. 


34. You view applets with the applet viewer or a Java-enabled browser. 


35. Ellipse2D.Double and Line2D.Doub1e are classes that describe graphical shapes. 


36. The drawString method draws a string, starting at its basepoint. 


37. When you set a new color in the graphics context, it is used for subsequent 


drawing operations. 


FURTHER READING 


1. http://ww.bluej.org The Blue] development environment. 


2. http://drjava.sourceforge.net The Dr. Java development environment. 


3. http://java.sun.com/javase/6/docs/api/index.htm] The documentation of the 


Java API. 


4, http://java.com The consumer-oriented web site for Java technology. Download the 


Java plugin from this site. 


5. http://www.gnu.org The web site of the GNU project. 


6. http://ww.gutenberg.org The web site of Project Gutenberg, offering the text of 


classical books. 


CLASSES, OBJECTS, AND METHODS 


INTRODUCED IN THIS CHAPTER 


java.awt.Color 
java.awt.Component 

getHeight 

getwidth 

setSize 

setVisible 
java.awt.Frame 

setTitle 
java.awt.geom.Ellipse2D.Double 
java.awt.geom.Line2D.Double 
java.awt.geom.Point2D.Double 
java.awt.Graphics 

setColor 


java.awt.Graphics2D 
draw 
drawString 
TEL 
java.awt.Rectangle 
translate 
getxX 
gety 
getHeight 
getWidth 


java.lang.String 

length 

replace 

toLowerCase 

toUpperCase 
javax.swing.JComponent 

paintComponent 
javax.swing.JFrame 

setDefaultCloseOperation 
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REVIEW EXERCISES 


Exercise R2.1. Explain the difference between an object and an object reference. 
Exercise R2.2. Explain the difference between an object and an object variable. 
Exercise R2.3. Explain the difference between an object and a class. 


Exercise R2.4. Give the Java code for constructing an object of class Rectangle, and 
for declaring an object variable of class Rectangle. 


Exercise R2.5. Explain the difference between the = symbol in Java and in 
mathematics. 


Exercise R2.6. Uninitialized variables can be a serious problem. Should you always 
initialize every int or double variable with zero? Explain the advantages and disad- 
vantages of such a strategy. 


Exercise R2.7. Give Java code to construct the following objects: 
a. A rectangle with center (100, 100) and all side lengths equal to 50 
b. A string "Hello, Dave!" 
Create objects, not object variables. 
Exercise R2.8. Repeat Exercise R2.7, but now define object variables that are initial- 
ized with the required objects. 
Exercise R2.9. Find the errors in the following statements: 
a. Rectangle r = (5, 10, 15, 20); 
b. double width = Rectangle(5, 10, 15, 20).getwWidth(); 


c. Rectangle r; 
r.trans late(15.. 25); 


d. r = new Rectangle(Q); 
r.translateC"far, far away!"); 


Exercise R2.10. Name two accessor methods and two mutator methods of the 
Rectangle class. 


Exercise R2.11. Look into the API documentation of the Rectangle class and locate 
the method 
void add(int newx, int newy) 


Read through the method documentation. Then determine the result of the follow- 
ing statements: 


Rectangle box = new Rectangle(5, 10, 20, 30); 
box.add(0, 0); 


If you are not sure, write a small test program or use Blue]. 
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Exercise R2:12. Find an overloaded method of the String class. 
Exercise R213. Find an overloaded method of the Rectangle class. 


Exercise R2.14. What is the difference between a console application and a graphical 
application? 


Exercise R2.15. Who calls the paintComponent method of a component? When does 
the call to the paintComponent method occur? 


Exercise R2.16. Why does the parameter of the paintComponent method have type 
Graphics and not Graphics2D? 


Exercise R2.17. What is the purpose of a graphics context? 


Exercise R2.18. Why are separate viewer and component classes used for graphical 
programs? 


Exercise R2.19. How do you specify a text color? 


Additional review exercises are available in WileyPLUS. 


PROGRAMMING EXERCISES 


precise P21 Write an AreaTester program that constructs a Rectangle object and 
ther’ computes and prints its area. Use the getWidth and getHeight methods. Also 
print the expected answer. 


Exercise P2.2. Write a PerimeterTester program that constructs a Rectangle object 
and then computes and prints its perimeter. Use the getWidth and getHeight meth- 
ods. Also print the expected answer. 


Exercise P2.3. Write a program called FourRectanglePrinter that constructs a 
Rectangle object, prints its location by calling System.out.printIn(box), and then 
translates and prints it three more times, so that, if the rectangles were drawn, they 
would form one large rectangle: 
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Exercise P2.4. The intersection method computes the intersection of two rectan- 
gles—that is, the rectangle that is formed by two overlapping rectangles: 


Intersection 


You call this method as follows: 
Rectangle r3 = rl.intersection(r2); 


Write a program IntersectionPrinter that constructs two rectangle objects, prints 
them, and then prints the rectangle object that describes the intersection. Then the 
program should print the result of the intersection method when the rectangles do 
not overlap. Add a comment to your program that explains how you can tell 
whether the resulting rectangle is empty. 


Exercise P2.5. In the Java library, a color is specified by its red, green, and blue com- 
ponents between 0 and 255. Write a program BrighterDemo that constructs a Color 
object with red, green, and blue values of 50, 100, and 150. Then apply the brighter 
method and print the red, green, and blue values of the resulting color. (You won’t 
actually see the color—see Section 2.13 on how to display the color.) 


Exercise P2.6. Repeat Exercise P2.5, but apply the darker method twice to the pre- 
defined object Color.RED. Call your class DarkerDemo. 


Exercise P2.7. The Random class implements a random number generator, which pro- 
duces sequences of numbers that appear to be random. To generate random inte- 
gers, you construct an object of the Random class, and then apply the nextInt 
method. For example, the call generator.nextInt(6) gives you a random number 
between 0 and 5. 


Write a program DieSimulator that uses the Random class to simulate the cast of a die, 
printing a random number between 1 and 6 every time that the program is run. 


Exercise P2.8. Write a program LotteryPrinter that picks a combination in a lottery. 
In this lottery, players can choose 6 numbers (possibly repeated) between 1 and 49. 
(In a real lottery, repetitions aren’t allowed, but we haven’t yet discussed the pro- 
gramming constructs that would be required to deal with that problem.) Your pro- 
gram should print out a sentence such as “Play this combination—it’ll make you 
rich!”, followed by a lottery combination. 
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Exercise P2.9. Write a program ReplaceTester that encodes a string by replacing all 
letters "i" with "!" and all letters "s" with "$". Use the replace method. Demon- 
strate that you can correctly encode the string "Mississippi". Print both the actual 
and expected result. 


Exercise P2.10. Write a program HollePrinter that switches the letters "e" and "o" in 
a string. Use the replace method repeatedly. Demonstrate that the string "Hello, 
World!" turns into "Holle, Werld!" 


Exercise P2.11. Write a graphics program that draws your name in red, contained 
inside a blue rectangle. Provide a class NameViewer and a class NameComponent. 


Exercise P2.12. Write a graphics program that draws 12 strings, one each for the 12 
standard colors, besides Color.WHITE, each in its own color. Provide a class Color- 
NameViewer and a class ColorNameComponent. 


Exercise P2.13. Write a program that draws two solid squares: one in pink and one in 
purple. Use a standard color for one of them and a custom color for the other. Pro- 
vide a class TwoSquareVi ewer and a class TwoSquareComponent. 


Exercise P2.14. Write a program that fills the window with a large ellipse, with a 
black outline and filled with your favorite color. The ellipse should touch the win- 
dow boundaries, even if the window ts resized. 


Exercise P2.15. Write a program to plot the following face. 


Provide a class FaceViewer and a class FaceComponent. 


Additional programming exercises are available in WileyPLUS. 


Project 2.1. The GregorianCalendar class describes a point in time, as measured by 
the Gregorian calendar, the standard calendar that is commonly used throughout 
the world today. You construct a GregorianCalendar object from a year, month, and 
day of the month, like this: 


GregorianCalendar cal = new GregorianCalendar(); // Today’s date 
GregorianCalendar eckertsBirthday = new GregorianCalendar(1919, 
Calendar.APRIL, 9); 


Use constants Calendar. JANUARY . . . Calendar.DECEMBER to specity the month. 
The add method can be used to add a number of days to a GregorianCalendar object: 
cal.add(Calendar.DAY_OF_MONTH, 10); // Now cal is ten days from today 


This is a mutator method—it changes the cal object. 
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The get method can be used to query a given GregorianCalendar object: 


int dayOfMonth = cal.get(Calendar.DAY_OF_MONTH) ; 
int month = cal.get(Calendar.MONTH) ; 
int year = cal.get(Calendar. YEAR) ; 
int weekday = cal.get(Calendar.DAY_OF_WEEK) ; 
// 11s Sunday, 2 is Monday, ..., 7 is Saturday 


Your task is to write a program that prints the following information: 
e The date and weekday that is 100 days from today 
e The weekday of your birthday 
e The date that is 10,000 days from your birthday 
Use the birthday of a computer scientist if you don’t want to reveal your own 
birthday. 
**KG Project 2.2. Run the following program: 


import java.awt.Color; 
import javax.swing.JFrame; 
import javax.swing.JTextField; 


public class FrameTester 


public static void main(String[] args) 


{ 


JFrame frame = new JFrameQ); 

frame.setSize(200, 200); 

JTextField text = new JTextFieldC"Hello, World!"); 
text.setBackground(Color. PINK) ; 

frame.add(text) ; 
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
frame.setVisible(true); 


} 
Modity the program as follows: 
¢ Double the frame size 
e Change the greeting to “Hello, your name!” 
e Change the background color to pale green (see Exercise P2.5) 
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ANSWERS TO SELF-CHECK QUESTIONS 


1 a ae a 


int and String 

Only the first two are legal identifiers. 

String myName = "John Q. Public"; 

No, the left-hand side of the = operator must be a variable. 
greeting = "Hello, Nina!"; 

Note that 


String greeting = "Hello, Nina!"; 
is not the right answer—that statement defines a new variable. 


river. length() or "Mississippi". lengthQ 


7. System.out.printIn(greeting. toUpperCase()); 


It is not legal. The variable river has type String. The print1n method is not a 
method of the String class. 


The implicit parameter is river. There is no explicit parameter. The return value 
is 11, 


. "Missississi" 
« IZ 
. As public String toUpperCase(), with no explicit parameter and return type 


String. 


. double 

. An int is not an object, and you cannot call a method on it. 
- (x + y) * 0.5 

. new Rectangle(90, 90, 20, 20) 


0 


. An accessor—it doesn’t modify the original string but returns a new string with 


uppercase letters. 


. box.translate(-5, -10), provided the method is called immediately after stor- 


ing the new rectangle into box. 
x: 30, y: 25 


. Because the translate method doesn’t modify the shape of the rectangle. 
. Add the statement import java.util.Random; at the top of your program. 


23. toLowerCase 
24. "Hello, Space !"—only the leading and trailing spaces are trimmed. 
25. Now greeting and greeting2 both refer to the same String object. 


. Both variables still refer to the same string, and the string has not been modi- 


fied. Recall that the toUpperCase method constructs a new string that contains 
uppercase characters, leaving the original string unchanged. 
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Modify the EmptyFrameViewer program as follows: 


frame.setSize(300, 300); 
frame.setTitleC"Hello, World!"); 


Construct two JFrame objects, set each of their sizes, and call setVisible(true) 


on each of them. 

Rectangle box = new Rectangle(5, 10, 20, 20); 

Replace the call to box. translate(15, 25) with 

box = new Rectangle(20, 35, 20, 20); 

The compiler complains that g doesn’t have a draw method. 
g2.draw(new Ellipse2D.Double(75, 75, 50, 50)); 


Line2D.Double segmentl = new Line2D.Double(0O, 0, 10, 30); 
g2.draw(segmentl) ; 
Line2D.Double segment2 = new Line2D.Double(10, 30, 20, 0); 
g2.draw(segment2) ; 


g2.drawString("V", 0, 30); 
0, 0, 295 
First fill a big red square, then fill a small yellow square inside: 


g2.setColor(Color.RED) ; 

g2.fill(Cnew Rectangle(0O, 0, 200, 200)); 
g2.setColor(Color. YELLOW) ; 

g2.fi1]1(new Rectangle(50, 50, 100, 100)); 


G To implement classes for drawing graphical shapes 


fies 


To Heche familiar with the process of impleneet ae classes 
To be able to implement simple methods 

To understand the purpose and use of constructors 

lo understand how to access instance fields and local variables 


To appreciate the importance of documentation comments 


In this chapter, you will learn how to implement your own classes. You will start 
with a given design that specifies the public interface of the class—that is, the 
methods through which programmers can manipulate the objects of the class. You 
then need to implement the methods. This step requires that you find a data 
representation for the objects, and supply the instructions for each method. You 
then provide a tester to validate that your class works correctly. You also document 


your efforts so that other programmers can understand and use your creation. 
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When you lift the hood of a car, you will find a bewildering collection of mechani- 
cal components. You will probably recognize the motor and the tank for the wind- 
shield washer fluid. Your car mechanic will be able to identify many other 
components, such as the transmission and the electronic control module—the 
device that controls the timing of the spark plugs and the flow of gasoline into the 
motor. But ask your mechanic what is inside the electronic control module, and you 
will likely get a shrug. 

It is a black box, something that magically does its thing. A car mechanic would 
never open the box—it contains electronic parts that can only be serviced at the fac- 
tory. Of course, the device may have a color other than black, and it may not even 
be box-shaped. But engineers use the term “black box” to describe any device 
whose inner workings are hidden. Note that a black box is not totally mysterious. 
Its interaction with the outside world is well-defined. For example, the car 
mechanic can test that the engine control module sends the right firing signals to the 
spark plugs. 
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Why do car manufacturers put black boxes into cars? The black box greatly sim- 
plifies the work of the car mechanic, leading to lower repair costs. If the box fails, it 
is simply replaced with a new one. Before engine control modules were invented, 
gasoline flow into the engine was regulated by a mechanical device called a carbure- 
tor, a notoriously fussy mess of springs and latches that was expensive to adjust and 
repair. 

Of course, for many drivers, the entire car is a “black box”. Most drivers know 
nothing about its internal workings and never want to open the hood in the first 
place. The car has pedals, buttons, and a gas tank door. If you give it the right 
inputs, it does its thing, transporting you from here to there. 

And for the engine control module manufacturer, the transistors and capacitors 
that go inside are black boxes, magically produced by an electronics component 
manufacturer. 

In technical terms, a black box provides encapsulation, the hiding of unimportant 
details. Encapsulation is very important for human problem solving. A car mechanic 
is more efficient when the only decision is to test the electronic control module and 
to replace it when it fails, without having to think about the sensors and transistors 
inside. A driver is more efficient when the only worry is putting gas in the tank, not 
thinking about the motor or electronic control module inside. 

However, there is another aspect to encapsulation. Somebody had to come up 
with the right concept for each particular black box. Why do the car parts manufac- 
turers build electronic control modules and not another device? Why do the trans- 
portation device manufacturers build cars and not personal helicopters? 

Concepts are discovered through the process of abstraction, taking away inessen- 
tial features, until only the essence of the concept remains. For example, “car” is an 
abstraction, describing devices that transport small groups of people, traveling on 
the ground, and consuming gasoline. Is that the right abstraction? Or is a vehicle 
with an electric engine a “car”? We won’t answer that question and instead move on 
to the significance of encapsulation and abstraction in computer science. 


3.1.2 Object-Oriented Design 


In old times, computer programs manipulated primitive types such as numbers and 
characters. As programs became more complex, they manipulated more and more 
of these primitive quantities, until programmers could no longer keep up. It was 
just too confusing to keep all that detail in one’s head. As a result, programmers 
gave wrong instructions to their computers, and the computers faithfully executed 
them, yielding wrong answers. 

Of course, the answer to this problem was obvious. Software developers soon 
learned to manage complexity. They encapsulated routine computations, forming 
software “black boxes” that can be put to work without worrying about the inter- 
nals. They used the process of abstraction to invent data types that are at a higher 
level than numbers and characters. 

At the time that this book is written, the most common approach for structuring 
computer programming is the object-oriented approach. The black boxes from 
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which a program is manufactured are called objects. An object has an internal struc- 
ture—perhaps just some numbers, perhaps other objects—and a well-defined 
behavior. Of course, the internal structure is hidden from the programmer who uses 
it. That programmer only learns about the object’s behavior and then puts it to 
work in order to achieve a higher-level goal. 

Who designs these objects? Other programmers! What do they contain? Other 
objects! This is where things get confusing for beginning students. In real life, the 
users of black boxes are quite different from their designers, and it is easy to under- 
stand the levels of abstraction (see Figure 1). With computer programs, there are 
also levels of abstraction (see Figure 2), but they are not as intuitive to the 
uninitiated. To make matters potentially more confusing, you will often need to 
switch roles, being the designer of objects in the morning and the user of the same 
objects in the afternoon. In that regard, you will be like the builders of the first 
automobiles, who singlehandedly produced steering wheels and axles and then 
assembled their own creations into a car. 

There is another challenging aspect of designing objects. Software is infinitely 
more flexible than hardware because it is unconstrained from physical limitations. 
Designers of electronic parts can exploit a limited number of physical effects to cre- 
ate transistors, capacitors, and the like. Transportation device manufacturers can’t 
easily produce personal helicopters because of a whole host of physical limitations, 
such as fuel consumption and safety. But in software, anything goes. With few con- 
straints from the outside world, you can design good and bad abstractions with 
equal facility. Understanding what makes good design is an important part of the 
education of a software engineer. 
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In Chapter 2, you learned to be an object user. You saw how to obtain objects, how 
to manipulate them, and how to assemble them into a program. In that chapter, 
your role was analogous to the automotive engineer who learns how to use an 
engine control module, and how to take advantage of its behavior in order to build 
a Car. 

In this chapter, you will move on to implementing classes. A design will be 
handed to you that describes the behavior of the objects of a class. You will learn 
the necessary Java programming techniques that enable your objects to carry out 
the desired behavior. In these sections, your role is analogous to the car parts manu- 
facturer who puts together an engine control module from transistors, capacitors, 
and other electronic parts. 

In Chapters 8 and 12, you will learn more about designing your own classes. You 
will learn rules of good design, and how to discover the appropriate behavior of 
objects. In those chapters, your job is analogous to the car parts engineer who spec- 
ifies how an engine control module should function. 


SELF CHECK 


1, In Chapters 1 and 2, you used System. out as a black box to cause output to 
appear on the screen. Who designed and implemented System. out? 


2. Suppose you are working in a company that produces personal finance soft- 
ware. You are asked to design and implement a class for representing bank 
accounts. Who will be the users of your class? 


In this section, we will discuss the process of specifying the behavior of a class. 
Imagine that you are a member of a team that works on banking software. A funda- 
mental concept in banking is a bank account. Your task is to understand the design 
of a BankAccount class so that you can implement it, which in turn allows other pro- 
grammers on the team to use it. 

You need to know exactly what features of a bank account need to 
be implemented. Some features are essential (such as deposits), 
whereas others are not important (such as the gift that a customer 
may receive for opening a bank account). Deciding which features are 
essential is not always an easy task. We will revisit that issue in Chap- 
ters 8 and 12. For now, we will assume that a competent designer has 
decided that the following are considered the essential operations of a bank account: 


class, you first - 
know which me 


¢ Deposit money 
¢ Withdraw money 


® Get the current balance 


~ 
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In Java, operations are expressed as method calls. To figure out the exact specifi- 
cation of the method calls, imagine how a programmer would carry out the bank 
account operations. We’ll assume that the variable harrysChecking contains a refer- 
ence to an object of type BankAccount. We want to support method calls such as the 
following: 


harrysChecking. deposit (2000) ; 
harrysChecking.withdraw(500) ; 
System. out.printInCharrysChecking.getBalance()) ; 


Note that the first two methods are mutators. They modify the balance of the bank 
account and don’t return a value. The third method is an accessor. It returns a value 
that you can print or store in a variable. 

As you can see from the sample calls, the BankAccount class should define three 
methods: 


® public void deposit(double amount) 
® public void withdraw(double amount) 


® public double getBalance() 


Recall from Chapter 2 that double denotes the double-precision floating-point type, 
and void indicates that a method does not return a value. 

When you define a method, you also need to provide the method body, consist- 
ing of statements that are executed when the method is called. 


public void deposit(double amount) 


body —filled in later 


You will see in Section 3.5 how to fill in the method body. 
Every method definition contains the following parts: 


° An access specifier (usually public) 
¢ The return type (such as void or double) 
e The name of the method (such as deposit) 


© A list of the parameters of the method (if any), enclosed in parentheses (such as 
double amount) 


¢ The body of the method: statements enclosed in braces 


The access specifier controls which other methods can call this 
method. Most methods should be declared as public. That way, all 
other methods in a program can call them. (Occasionally, it can be 
useful to have private methods. They can only be called from other 
methods of the same class.) 

The return type is the type of the output value. The deposit method 
does not return a value, whereas the getBalance method returns a 
value of type double. 
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SYNTAX 3.1 Method Definition 


accessSpecifier returnType methodName (parameterType parameterName, .. . ) 


{ 
method body 


Example: 


public void deposit(double amount) 


! 
} 


Purpose: 


To define the behavior of a method 


Each parameter (or input) to the method has both a type and a name. For exam- 
ple, the deposit method has a single parameter named amount of type double. For 
each parameter, choose a name that is both a legal variable name and a good descrip- 
tion of the purpose of the input. 

Next, you need to supply constructors. We will want to construct bank accounts 
that initially have a zero balance, by using the default constructor: 


BankAccount harrysChecking = new BankAccount(); 


What if a programmer who uses our class wants to start out with another balance? 
A second constructor that sets the balance to an initial value will be useful: 


BankAccount momsSavings = new BankAccount(5000) ; 


To summarize, it is specified that two constructors will be provided: 


® public BankAccount() 


® public BankAccount(double initialBalance) 
A constructor 1s very similar to a method, with two important differences. 


¢ The name of the constructor is always the same as the name of the class (e.g., 
BankAccount) 


¢ Constructors have no return type (not even void) 


Just like a method, a constructor also has a body—a sequence of 


- Constructors contain ae 
| ne statements that is executed when a new object is constructed. 


instructions to initialize 
objects. The constructor public BankAccount() 
name is always the same 

-astheclassmame. | body —filled in later 
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The statements in the constructor body will set the internal data of the object that is 
being constructed —see Section 3.5. 

Don’t worry about the fact that there are two constructors with the same name— 
all constructors of a class have the same name, that is, the name of the class. The 
compiler can tell them apart because they take different parameters. 

When defining a class, you place all constructor and method definitions inside, 


like this: 


public class BankAccount 


1 
// Constructors 
public BankAccount() 


body —filled in later 


public BankAccount(double initialBalance) 


body—filled in later 


// Methods 


public void deposit(double amount) 


body —filled in later 


public void withdraw(double amount) 


body —filled in later 


public double getBalance() 


body—filled in later 
} 


private fields—filled in later 
} 


You will see how to supply the missing pieces in the following sections. 

The public constructors and methods of a class form the public interface of the 
class. These are the operations that any programmer can use to create and manipu- 
late BankAccount objects. Our BankAccount class is simple, but it allows programmers 
to carry out all of the important operations that commonly occur with bank 
accounts. For example, consider this program segment, authored by a programmer 
who uses the BankAccount class. These statements transfer an amount of money 
from one bank account to another: 


// Transfer from one account to another 
double transferAmount = 500; 
momsSavings.withdraw(transferAmount) ; 
harrysChecking.deposit(transferAmount) ; 
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SYNTAX 3.2 Constructor Definition 


accessSpecifier ClassName(parameterType parameterName, ... ) 


{ 


constructor body 


} 


Example: 


public BankAccount(double initialBalance) 


{ 
} 


Purpose: 


To define the behavior of a constructor 


SYNTAX 3.3 Class Definition 


accessSpecifier class ClassName 


{ 


constructors 
methods 


fields 
} 


Example: 


public class BankAccount 


t 
public BankAccount(double initialBalance) { .. . } 
public void deposit(double amount) { ... } 


} 


Purpose: 


To define a class, its public interface, and its implementation details 


And here is a program segment that adds interest to a savings account: 


double interestRate = 5; // 5% interest 
double interestAmount 

= momsSavings.getBalance() * interestRate / 100: 
momsSavings.deposit(interestAmount) ; 
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As you can see, programmers can use objects of the BankAccount class to carry out 
meaningful tasks, without knowing how the BankAccount objects store their data or 
how the BankAccount methods do their work. 

Of course, as implementors of the BankAccount class, we will need to supply the 
internal details. We will do so in Section 3.5. First, however, an important step 
remains: documenting the public interface. That is the topic of the next section. 


SELF CHECK 


3. How can you use the methods of the public interface to empty the harrys- 
Checking bank account? 


4. Suppose you want a more powerful bank account abstraction that keeps track 
of an account number in addition to the balance. How would you change the 
public interface to accommodate this enhancement? 


When you implement classes and methods, you should get into the habit of thor- 
oughly commenting their behaviors. In Java there is a very useful standard form for 
documentation comments. If you use this form in your classes, a program called 
javadoc can automatically generate a neat set of HTML pages that describe them. 
(See Productivity Hint 3.1 for a description of this utility.) 

A documentation comment is placed before the class or method 
definition that is being documented. It starts with a /**, a special 
comment delimiter used by the javadoc utility. Then you describe the 
method’s purpose. Then, for each method parameter, you supply a line 
that starts with @param, followed by the parameter name and a short 
explanation. Finally, you supply a line that starts with @return, describing the return 
value. You omit the @param tag for methods that have no parameters, and you omit 
the @return tag for methods whose return type 1s void. 

The javadoc utility copies the first sentence of each comment to a summary table 
in the HTML documentation. Therefore, it is best to write that first sentence with 
some care. It should start with an uppercase letter and end with a period. It does not 
have to be a grammatically complete sentence, but it should be meaningful when it 
is pulled out of the comment and displayed in a summary. 

Here are two typical examples. 


Withdraws money from the bank account. 
@param amount the amount to withdraw 


public void withdraw(double amount) 


{ 


implementation — filled in later 
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Gets the current balance of the bank account. 
@return the current balance 

* / 

public double getBalance() 

{ 


implementation —filled in later 


} 


The comments you have just seen explain individual methods. Supply a brief com- 
ment for each class, explaining its purpose. The comment syntax for class comments 
is very simple: Just place the documentation comment above the class. 


A bank account has a balance that can be changed by 
deposits and withdrawals. 


public class BankAccount 


{ 
} 


Your first reaction may well be “Whoa! Am I supposed to write all this stuff?” 
These comments do seem pretty repetitive. But you should take the time to write 
them, even if it feels silly. 

It is always a good idea to write the method comment first, before writing the 
code in the method body. This is an excellent test to see that you firmly understand 
what you need to program. If you can’t explain what a class or method does, you 
aren't ready to implement it. 

What about very simple methods? You can easily spend more 
time pondering whether a comment is too trivial to write than it 
takes to write it. In practical programming, very simple methods are 
rare. It is harmless to have a trivial method overcommented, 
whereas a complicated method without any comment can cause real 
: grief to future maintenance programmers. According to the standard 
me decuimencr on style, every class, every method, every parameter, and every 
return value should have a comment. 

The javadoc utility formats your comments into a neat set of documents that you 
can view in a web browser. It makes good use of the seemingly repetitive phrases. 
The first sentence of the comment is used for a summary table of all methods of 
your class (see Figure 3). The @param and @return comments are neatly formatted in 
the detail description of each method (see Figure 4). If you omit any of the com- 
ments, then javadoc generates documents that look strangely empty. 

This documentation format should look familiar. The programmers who imple- 
ment the Java library use javadoc themselves. They too document every class, every 
method, every parameter, and every return value, and then use javadoc to extract 
the documentation in HTML format. 
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i® |BankAccount - Firefox 
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Gir EG fleuthomeycay/Biglava/cho3/accountindex:htm! 
lal Classes | |BankAccount(double initialBalance) | 

: | Constructs 4 bank account with a given balance, 


BaniAerDuht Teste | | | 
||/Method Summary | 
| deposit(double amount) 
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| | double | getBalance(} 
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Figure 4 Method Detail Generated by javadoc 


SELF CHECK 


5. Suppose we enhance the BankAccount class so that each account has an account 
number. Supply a documentation comment for the constructor 


public BankAccount(int accountNumber, double initialBalance) 


6. Why is the following documentation comment questionable? 
/* * 
Each account has an account number. 
@return the account number of this account 
% / 
public int getAccountNumber () 
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PRODUCTIVITY HINT 3.1 


The javadoc Utility 


Always insert documentation comments in your code, whether or not you use javadoc to 
produce HTML documentation. Most people find the HTML documentation convenient, 
so it is worth learning how to run javadoc. Some programming environments (such as Blue]J) 
can execute javadoc for you. Alternatively, you can invoke the javadoc utility from a com- 
mand shell, by issuing the command 


javadoc MyClass.java 
or , if you want to document multiple Java files, 
javadoc *.java 


The javadoc utility produces files such as MyClass. htm] in HTML format, which you can 
inspect in a browser. If you know HTML (see Appendix H), you can embed HTML tags 
into the comments to specify fonts or add images. Perhaps most importantly, javadoc auto- 
matically provides hyperlinks to other classes and methods. 

You can run javadoc before implementing any methods. Just leave all the method bodies 
empty. Don’t run the compiler—it would complain about missing return values. Simply run 
javadoc on your file to generate the documentation for the public interface that you are 
about to implement. 

The javadoc tool is wonderful because it does one thing right: It allows you to put the 
documentation together with your code. That way, when you update your programs, you 
can see right away which documentation needs to be updated. Hopefully, you will update it 
right then and there. Afterward, run javadoc again and get updated information that 1s 
timely and nicely formatted. 


Now that you understand the specification of the public interface of the Bank- 
Account class, let’s provide the implementation. 

First, we need to determine the data that each bank account object contains. In 
the case of our simple bank account class, each object needs to store a single value, 
the current balance. (A more complex bank account class might store additional 
data—perhaps an account number, the interest rate paid, the date for mailing out 
the next statement, and so on.) 

An object stores its data in instance fields. A field is a technical 
term for a storage location inside a block of memory. An instance of a 
class is an object of the class. Thus, an instance field is a storage loca- 
tion that is present in each object of the class. 

The class declaration specifies the instance fields: 


An object uses instance - 
fields to store its state— 
the data that it needs to 
execute its methods. _ 


public class BankAccount 


{ 


private double balance; 
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Figure 5 Instance Fields 


An instance field declaration consists of the following parts: 


e An access specifier (usually private) 
e The type of the instance field (such as double) 


e The name of the instance field (such as balance) 


Each object of a class has its own set of instance fields. For example, 
if harrysChecking and momsSavings are two objects of the BankAccount 
: class, then each object has its own balance field, called harrys- 
enc ~ Checking.balance and momsSavings.balance (see Figure 5). 

Instance fields are generally declared with the access specifier 
private. That specifier means that they can be accessed only by the 
methods of the same class, not by any other method. For example, 
the balance variable can be accessed by the deposit method of the 
BankAccount class but not the main method of another class. 


Each object of a class 
its own set of ins 


public class BankRobber 


{ 

public static void main(String[] args) 

{ | 
BankAccount momsSavings = new BankAccount(1000) ; 
momsSavings.balance = -1000; // Error 

} 

; 


In other words, if the instance fields are declared as private, then all 
data access must occur through the public methods. Thus, the instance 
fields of an object are effectively hidden from the programmer who 
uses a class. They are of concern only to the programmer who imple- 
ments the class. The process of hiding the data and providing methods 
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SYNTAX 3.4 Instance Field Declaration 


accessSpecifier class ClassName 


{ 
geeesspeanen fieldType fieldName; 
oe % 
Example: 
public class BankAccount 
{ 
oe iaae double balance; 
} 
Purpose: 


To define a field that is present in every object of a class 


SELF CHECK 
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for data access is called encapsulation. Although it is theoretically possible in Java 
to leave instance fields public, that is a very uncommon practice. We will always 
make instance fields private in this book. 


7. Suppose we modify the BankAccount class so that each bank account has an 
account number. How does this change affect the instance fields? 


8. What are the instance fields of the Rectangle class? 


ates instance aia an 


“obj ject. 


Constructors contain | - 


Constructors and 


Methods. 


Now that we have determined the instance fields, let us complete the 
BankAccount class by supplying the bodies of the constructors and 
methods. Each body contains a sequence of statements. We'll start 
with the constructors because they are very straightforward. A con- 


structor has a simple job: to initialize the instance fields of an object. 
Recall that we designed the BankAccount class to have two construc- 


tors. The first constructor simply sets the balance to zero: 


public BankAccount() 
{ 


} 


balance = 0; 
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The second constructor sets the balance to the value supplied as the construction 
PP 
parameter: 


public BankAccount(double initialBalance) 


i 
: 


To see how these constructors work, let us trace the statement 


balance = initialBalance; 


BankAccount harrysChecking = new BankAccount(1000) ; 


one step at a time. Here are the steps that are carried out when the statement 
executes. 

* Create a new object of type BankAccount. 

° Call the second constructor (since a construction parameter is supplied). 

¢ Set the parameter variable initialBalance to 1000. 

¢ Set the balance instance field of the newly created object to initialBalance. 


* Return an object reference, that is, the memory location of the object, as the 
value of the new expression. 


¢ Store that object reference in the harrysChecking variable. 


Let’s move on to implementing the BankAccount methods. Here is the deposit 
method: 


public void deposit(double amount) 


{ 
double newBalance = balance + amount; 
balance = newBalance; 


} 
To understand exactly what the method does, consider this statement: 
harrysChecking.deposit(500) ; 


This statement carries out the following steps: 


e Set the parameter variable amount to 500. 


Fetch the balance field of the object whose location is stored in harrysChecking. 


Add the value of amount to balance and store the result in the variable newBalance. 


e 


Store the value of newBalance in the balance instance field, overwriting the old 
value. 


The withdraw method is very similar to the deposit method: 


public void withdraw(double amount) 

{ 
double newBalance = balance - amount; 
balance = newBalance; 
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SYNTAX 3.5 The return Statement 


return expression; 
or 
return; 


Example: 


return balance; 


Purpose: 


To specify the value that a method returns, and exit the method immediately. The return 
value becomes the value of the method call expression. 


There is only one method left, getBalance. Unlike the deposit and withdraw meth- 
ods, which modify the instance fields of the object on which they are invoked, the 
getBalance method returns an output value: 


public double getBalance() 
{ 


return balance; 


The return statement is a special statement that instructs the method 
to terminate and return an output to the statement that called the 
method. In our case, we simply return the value of the balance 
instance field. You will later see other methods that compute and 
return more complex expressions. 

We have now completed the implementation of the BankAccount 
class—see the code listing below. There is only one step remaining: testing that the 
class works correctly. That is the topic of the next section. 


ch03/account/BankAccount.java 


K* 


A bank account has a balance that can be changed by 
deposits and withdrawals. 
* / 


public class BankAccount 


ale ale 
won 


Constructs a bank account with a zero balance. 


public BankAccount() 


11 { 
12 balance = 0; 
13 } 
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15 a 

16 Constructs a bank account with a given balance. 
17 @param initialBalance the initial balance 
18 * / 

19 public BankAccount(double initialBalance) 
20 { 

ii balance = initialBalance; 

22 } 

23 

24 [we 

25 Deposits money into the bank account. 

26 @param amount the amount to deposit 

27 * 

28 public void deposit(double amount) 

29 { 

30 double newBalance = balance + amount; 
31 balance = newBalance; 

32 } 

33 

34 ts 

35 Withdraws money from the bank account. 
36 @param amount the amount to withdraw 
37 * 

38 public void withdraw(double amount) 

39 { 

40 double newBalance = balance - amount; 
41 balance = newBalance; 

42 } 

43 

44 we 

45 Gets the current balance of the bank account. 
46 @return the current balance 

47 * / 

48 public double getBalance() 

49 f 

50 return balance; 

51 } 

52 

53 private double balance; 

54 } 

SELF CHECK 


9. The Rectangle class has four instance fields: x, y, width, and height. Give a 
possible implementation of the getwidth method. 


10. Give a possible implementation of the translate method of the Rectangle class. 
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How To 3.1 


implementing a Class 


This is the first of several “How To” sections in this book. Users of the Linux operating sys- 
tem have how to guides that give answers to the common questions “How do I get started?” 
and “What do I do next?”. Similarly, the How To sections in this book give you step-by-step 
procedures for carrying out specific tasks. 

You will often be asked to implement a class. For example, a homework assignment might 
ask you to implement a CashRegister class. 


Step 1. Find out which methods you are asked to supply. 


In the cash register example, you won’t have to provide every feature of a real cash register — 
there are too many. The assignment should tell you which aspects of a cash register your class 
should simulate. You should have received a description, in plain English, of the operations 
that an object of your class should carry out, such as this one: 


e Ring up the sales price for a purchased item. 
e Enter the amount of payment. 
e Calculate the amount of change due to the customer. 


For simplicity, we are looking at a very simple cash register here. A more sophisticated 
model would be able to compute sales tax, daily sales totals, and so on. 


Step 2. Specify the public interface. 


Turn the list in Step 1 into a set of methods, with specific types for the parameters and the 
return values. Many programmers find this step simpler if they write out method calls that 
are applied to a sample object, like this: 


CashRegister register = new CashRegister(); 
register.recordPurchase(29.95); 
register.recordPurchase(9.95); 
register.enterPayment (50) ; 

double change = register.giveChange() ; 


Now we have a specific list of methods. 
® public void recordPurchase(double amount) 
@ public void enterPayment(double amount) 


® public double giveChange() 


To complete the public interface, you need to specify the constructors. Ask yourself what 
information you need in order to construct an object of your class. Sometimes you will want 
two constructors: one that sets all fields to a default and one that sets them to user-supplied 
values. 

In the case of the cash register example, we can get by with a single constructor that cre- 
ates an empty register. A more realistic cash register would start out with some coins and 
bills so that we can give exact change, but that is beyond the scope of our assignment. 

Thus, we add a single constructor: 


e public CashRegister() 
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Step 3. Document the public interface. 


Here is the documentation, with comments, that describes the class and its methods: 


A cash register totals up sales and computes change due. 
* / 
public class CashRegister 
{ 

i . . ° ° 

Constructs a cash register with no money in it. 

* / 

public CashRegister() 

{ 

} 


Records the sale of an item. 
@param amount the price of the item 
* / 
public void recordPurchase(double amount) 
{ 
} 


/* %* 
Enters the payment received from the customer. 
@param amount the amount of the payment 
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public void enterPayment(double amount) 

{ 

} 


[x 
Computes the change due and resets the machine for the next customer. 
@return the change due to the customer 

=f 
public double giveChange() 
: 
} 
} 


Step 4 Determine instance fields. 


Ask yourself what information an object needs to store to do its job. Remember, the meth- 
ods can be called in any order! The object needs to have enough internal memory to be able 
to process every method using just its instance fields and the method parameters. Go 
through each method, perhaps starting with a simple one or an interesting one, and ask your- 
self what you need to carry out the method’s task. Make instance fields to store the informa- 
tion that the method needs. 

In the cash register example, you would want to keep track of the total purchase amount 
and the payment. You can compute the change due from these two amounts. 


public class CashRegister 


{ 


private double purchase; 
private double payment; 
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Step 5 Implement constructors and methods. 


Implement the constructors and methods in your class, one at a time, starting with the easiest 
ones. For example, here is the implementation of the recordPurchase method: 


public void recordPurchase(double amount) 


{ 
double newlotal = purchase + amount; 
purchase = newlotal; 


; 


Here is the giveChange method. Note that this method is a bit more sophisticated —it com- 
putes the change due, and it also resets the cash register for the next sale. 


public double giveChange() 


{ 
double change = payment - purchase; 
purchase = 0; 
payment = OQ; 
return change; 
j 


If you find that you have trouble with the implementation, you may need to rethink your 
choice of instance fields. It is common for a beginner to start out with a set of fields that can- 
not accurately reflect the state of an object. Don’t hesitate to go back and add or modity 
fields. 

Once you have completed the implementation, compile your class and fix any compiler 
errors. 


Step 6 Test your class. 


Write a short tester program and execute it. The tester program can carry out the method 
calls that you found in Step 2. 


public class CashRegisterTester 


{ 
public static void main(String[] args) 
: 
CashRegister register = new CashRegister(); 
register. recordPurchase(29.50); 
register. recordPurchase(9. 25); 
register.enterPayment (50) ; 
double change = register.giveChange() ; 
System.out.printIn(Cchange) ; 
System.out.printInC"Expected: 11.25"); 
} 
} 
The output of this test program is: 
11.25 


Expected: 11.25 


Alternatively, if you use a program that lets you test objects interactively, such as BlueJ, con- 
struct an object and apply the method calls. 
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In the preceding section, we completed the implementation of the BankAccount class. 
What can you do with it? Of course, you can compile the file BankAccount. java. 
However, you can’t execute the resulting BankAccount.class file. It doesn’t contain a 
main method. That is normal—most classes don’t contain a main method. 

In the long run, your class may become a part of a larger program 
that interacts with users, stores data in files, and so on. However, 
before integrating a class into a program, it is always a good idea to 
test it in isolation. Testing in isolation, outside a complete program, is 
| called unit testing. 

To test your class, you have two choices. Some interactive development environ- 
ments have commands for constructing objects and invoking methods (see 
Advanced Topic 2.1). Then you can test a class simply by constructing an object, 
calling methods, and verifying that you get the expected return values. Figure 6 
shows the result of calling the getBalance method on a BankAccount object in Blue]. 

Alternatively, you can write a tester class. A tester class is a class 
with a main method that contains statements to run methods of 
another class. A tester class typically carries out the following steps: 


A unit test veri ies that a. 
class works correctly in 
isolation, 
complete | 


1. Construct one or more objects of the class that is being tested. 


. Invoke one or more methods. 


2 
3. Print out one or more results. 
4 


. Print the expected results. 


Project Eait Tools, ae 


4 5 


Cone | 


Figure 6 
The Return Value of the 
getBalance Method in Blue} 
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The MoveTester class in Section 2.8 is a good example of a tester class. That class 
runs methods of the Rectangle class—a class in the Java library. 

Here is a class to run methods of the BankAccount class. The main method con- 
structs an object of type BankAccount, invokes the deposit and withdraw methods, 
and then displays the remaining balance on the console. 

We also print the value that we expect to see. In our sample program, we deposit 
$2,000 and withdraw $500. We therefore expect a balance of $1500. 


ch03/account/BankAccounttester.java 


l [e* 

Z A class to test the BankAccount class. 

3 % / 

4 public class BankAccountTester 

5 hf 

6 . 

7 Tests the methods of the BankAccount class. 

8 @param args not used 

Q * 
10 public static void main(String[] args) 
11 { 
12 BankAccount harrysChecking = new BankAccount(); 
13 harrysChecking.deposit(2009); 
14 harrysChecking.withdraw(500); 
15 System.out.printInCharrysChecking.getBalance()) ; 
16 System.out.printInC"Expected: 1500"); 
17 } 
18 } 
Output 

1500 


Expected: 1500 


To produce a program, you need to combine the BankAccount and the BankAccount- 
Tester classes. The details for building the program depend on your compiler and 
development environment. In most environments, you need to carry out these 
steps: 


1. Make a new subfolder for your program. 

2. Make two files, one for each class. 

3. Compile both files. 

4. Run the test program. 
Many students are surprised that such a simple program contains two classes. How- 
ever, this is normal. The two classes have entirely different purposes. The Bank- 


Account class describes objects that compute bank balances. The BankAccountTester 
class runs a test that puts a BankAccount object through its paces. 
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SELF CHECK 


11. When you run the BankAccountTester program, how many objects of class 
BankAccount are constructed? How many objects of type BankAccountTester? 


12. Why is the BankAccountTester class unnecessary in development environments 
that allow interactive testing, such as Blue]? 


PRODUCTIVITY HINT 3.2 
Using the Command Line Effectively 


If your programming environment allows you to accomplish all routine tasks using menus 
and dialog boxes, you can skip this note. However, if you must invoke the editor, the com- 
piler, the linker, and the program to test manually, then it is well worth learning about com- 
mand line editing. 

Most operating systems (including Linux, Mac OS X, UNIX, and Windows) have a com- 
mand line interface to interact with the computer. (In Windows XP, you can get a command 
line window by selecting “Run...” from the Start menu and typing cmd.) You launch com- 
mands at a prompt. The command is executed, and on completion you get another prompt. 

When you develop a program, you find yourself executing the same commands over and 
over. Wouldn’t it be nice if you didn’t have to type commands, such as 


javac MyProg.java 


more than once? Or if you could fix a mistake rather than having to retype the command in 
its entirety? Many command line interfaces have an option to do just that, by using the up 
and down arrow keys to recall old commands and the left and right arrow keys to edit lines. 
You can also perform file completion. For example, to select the file BankAccount. java, you 
only need to type the first couple of letters and then hit the “Tab” key. 

The details depend on your operating system and its configuration— experiment on your 
own, or ask a “power user” for help. 


We close this chapter with two sections of a more technical nature, examining vari- 
ables and parameters in some detail. 
You have seen three different categories of variables in this chapter: 


1. Instance fields (sometimes called instance variables), such as the balance 
variable of the BankAccount class 


2. Local variables, such as the newBalance variable of the deposit method 
3. Parameter variables, such as the amount variable of the deposit method 
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These variables are similar in one respect—they all hold values that 
belong to specific types. But they have a couple of important differ- 
ences. The first difference is their lifetime. 

An instance field belongs to an object. Each object has its own 
copy of each instance field. For example, if you have two BankAccount 
objects (say, harrysChecking and momsSavings), then each of them has 
its own balance field. When an object is constructed, its instance fields 
are reseed. The fields stay alive until no method uses the object any longer. (The 
Java virtual machine contains an agent called a garbage collector that periodically 
reclaims objects when they are no longer used.) 

Local and parameter variables belong to a method. When the method runs, these 
variables come to life. When the method exits, they die immediately (see Figure 7). 


Before method call 


Method called; parameter variable initialized 


Figure 7 Lifetime of Variables 
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For example, if you call 
harrysChecking.deposit(500) ; @ 


then a parameter variable called amount is created and initialized with the parameter 
value, 500. When the method returns, the amount variable dies. The same holds for 
the local variable newBalance. When the deposit method reaches the line 


double newBalance = balance + amount; & 


the variable comes to life and is initialized with the sum of the object’s balance and 
the deposit amount. The lifetime of that variable extends to the end of the method. 
However, the deposit method has a lasting effect. Its next line, 


balance = newBalance; &) 


sets the balance instance field, and that field lives beyond the end of the deposit 
method, as long as the BankAccount object is in use. 

The second major difference between instance fields and local 
variables is imitialization. You must initialize all local variables. If 
you don’t initialize a local variable, the compiler complains when 
you try to use it. 

Parameter variables are initialized with the values that are supplied 
in the method call. 

Instance fields are initialized with a default value if you don’t explicitly set them 
in a constructor. Instance fields that are numbers are initialized to 0. Object refer- 
ences are set to a special value called nu11. If an object reference is nu11, then it refers 
to no object at all. We will discuss the nu11 ale in greater detail in Section 525. 
Inadvertent initialization with 0 or nu11 is acommon cause of errors. Therefore, it is 
a matter of good style to initialize every instance field explicitly in every 
constructor. 


Instance fi 


SELF CHECK 


13. What do local variables and parameter variables have in common? In which 
essential aspect do they differ? 


14. During execution of the BankAccountTester program in the preceding section, 
how many instance fields, local variables, and parameter variables were created, 
and what were their names? 


COMMON ERROR 3.1 


Forgetting to Initialize Object References in a Constructor 


Just as it is a common error to forget to initialize a local variable, it is easy to forget about 
instance fields. Every constructor needs to ensure that all instance fields are set to appropri- 
ate values. 
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If you do not initialize an instance field, the Java compiler will initialize it for you. Num- 
bers are initialized with 0, but object references—such as string variables —are set to the nu11 
reference. 

Of course, 0 is often a convenient default for numbers. However, nu11 is hardly ever a 
convenient default for objects. Consider this “lazy” constructor for a modified version of the 
BankAccount class: 


public class BankAccount 


{ 
public BankAccount() {} // No statements 
private double balance; 
private String owner; 

} 


The balance is set to 0, and the owner field is set to a null reference. This is a problem—it 1s 
illegal to call methods on the nu11 reference. 

If you forget to initialize a local variable in a method, the compiler flags this as an error, 
and you must fix it before the program runs. If you make the same mistake with an imstance 
field in a class, the compiler provides a default initialization, and the error becomes apparent 
only when the program runs. 

To avoid this problem, make it a habit to initialize every instance field in every constructor. 


In Section 2.4, you learned that a method has an implicit parameter—the object on 

which the method is invoked—and explicit parameters, which are enclosed in 

parentheses. In this section, we will examine these parameters in greater detail. 
Have a look at a particular invocation of the deposit method: 


momsSavings.deposit(500) ; 
Now look again at the code of the deposit method: 


public void deposit(Cdouble amount) 


{ 
double newBalance = balance + amount; 
balance = newBalance; 


} 


The parameter variable amount is set to 500 when the deposit method starts. But 
what does balance mean exactly? After all, our program may have multiple Bank- 
Account objects, and each of them has its own balance. 

Of course, since we deposit the money into momsSavings, balance must mean 
momsSavings.balance. In general, when you refer to an instance field inside a 
method, it means the instance field of the object on which the method was called. 
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Thus, the call to the deposit method depends on two values: the 
object to which momsSavings refers, and the value 500. The amount 
parameter inside the parentheses is called an explicit parameter, 
because it is explicitly named in the method definition. However, the 
reference to the bank account object is not explicit in the method 
definition—it is called the implicit parameter of the method. 

If you need to, you can access the implicit parameter—the object 
on which the method is called—with the keyword this. For example, 
in the preceding method invocation, this was set to momsSavings and amount was set 
to 500 (see Figure 8). 

Every method has one implicit parameter. You don’t give the implicit parameter 
a name. It is always called this. (There is one exception to the rule that every 
method has an implicit parameter: static methods do not. We will discuss them in 
Chapter 8.) In contrast, methods can have any number of explicit parameters — 
which you can name any way you like—or no explicit parameter at all. 

Next, look closely at the implementation of the deposit method. The statement 


double newBalance = balance + amount; 
actually means 
double newBalance = this.balance + amount; 


When you refer to an instance field in a method, the compiler auto- 
matically applies it to the this parameter. Some programmers actu- 
ally prefer to manually insert the this parameter before every 
instance field because they find it makes the code clearer. Here is an 
example: 


Use of an instance field 


public void deposit(double amount) 


{ 
double newBalance = this.balance + amount; 
this.balance = newBalance; 


You may want to try it out and see if you like that style. 

You have now seen how to use objects and implement classes, and you have 
learned some important technical details about variables and method parameters. In 
the next chapter, you will learn more about the most fundamental data types of the 
Java language. 


“momsSavings = 


Figure 8 The Implicit Parameter of a Method Call 
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SELF CHECK 


15. How many implicit and explicit parameters does the withdraw method of the 
BankAccount class have, and what are their names and types? 


16. In the deposit method, what is the meaning of this.amount? Or, if the expres- 
sion has no meaning, why not? 


17. How many implicit and explicit parameters does the main method of the 
BankAccountTester class have, and what are they called? 


COMMON ERROR 3.2 
Trying to Call a Method Without an Implicit Parameter 


Suppose your main method contains the instruction 
withdraw(30); // Error 


The compiler will not know which account to access to withdraw the money. You need to 
supply an object reference of type BankAccount: 


BankAccount harrysChecking = new BankAccount(); 
harrysChecking.withdraw(30) ; 


However, there is one situation in which it is legitimate to invoke a method without, seem- 
ingly, an implicit parameter. Consider the following modification to the BankAccount class. 
Add a method to apply the monthly account fee: 


public class BankAccount 


, pea 
public void monthlyFee() 
{ 
withdraw(10); // Withdraw $10 from this account 
} 
} 


That means to withdraw from the same bank account object that is carrying out the monthly- 
Fee operation. In other words, the implicit parameter of the withdraw method is the (invisi- 
ble) implicit parameter of the monthlyFee method. 

If you find it confusing to have an invisible parameter, you can always use the this 
parameter to make the method easier to read: 


public class BankAccount 
< Ge & 
public void monthlyFee() 
{ 

this.withdraw(10); // Withdraw $10 from this account 
} 
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ADVANCED TOPIC 3.1 
Calling One Constructor from Another 


Consider the BankAccount class. It has two constructors: a constructor without parameters to 
initialize the balance with zero, and another constructor to supply an initial balance. Rather 
than explicitly setting the balance to zero, one constructor can call another constructor of the 
same class instead. There is a shorthand notation to achieve this result: 


public class BankAccount 


{ 
public BankAccount (double initialBalance) 
{ 
balance = initialBalance; 
} 
public BankAccount() 
{ 
this(0); 
} 
} 


The command this(0); means “Call another constructor of this class and supply the value 
0”. Such a constructor call can occur only as the first line in another constructor. 

This syntax is a minor convenience. We will not use it in this book. Actually, the use of 
the keyword this is a little confusing. Normally, this denotes a reference to the implicit 
parameter, but if this is followed by parentheses, it denotes a call to another constructor of 
this class. 


RANDOM FACT 3.1 


Electronic Voting Machines 


In the 2000 presidential elections in the United States, votes were tallied by a variety of 
machines. Some machines processed cardboard ballots into which voters punched holes to 
indicate their choices (see Punch Card Ballot figure). When voters were not careful, remains 
of paper—the now infamous “chads” —were partially stuck in the punch cards, causing votes 
to be miscounted. A manual recount was necessary, but it was not carried out everywhere 
due to time constraints and procedural wrangling. The election was very close, and there 
remain doubts in the minds of many people whether the election outcome would have been 
different if the voting machines had accurately counted the intent of the voters. 

Subsequently, voting machine manufacturers have argued that electronic voting machines 
would avoid the problems caused by punch cards or optically scanned forms. In an elec- 
tronic voting machine, voters indicate their preferences by pressing buttons or touching 
icons on a computer screen. Typically, each voter is presented with a summary screen for 
review before casting the ballot. The process is very similar to using an automatic bank teller 
machine (see Touch Screen Voting Machine figure). 

It seems plausible that these machines make it more likely that a vote is counted in the 
same way that the voter intends. However, there has been significant controversy 
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Punch Card Ballot 


surrounding some types of electronic voting machines. If a machine simply records the votes 
and prints out the totals after the election has been completed, then how do you know that 
the machine worked correctly? Inside the machine is a computer that executes a program, 
and, as you may know from your own experience, programs can have bugs. 

In fact, some electronic voting machines do have bugs. There have been isolated cases 
where machines reported tallies that were impossible. When a machine reports far more or 
far fewer votes than voters, then it is clear that it malfunctioned. Unfortunately, it is then 
impossible to find out the actual votes. Over time, one would expect these bugs to be fixed in 
the software. More insidiously, if the results are plausible, nobody may ever investigate. 

Many computer scientists have spoken out on this issue and confirmed that it is impossi- 
ble, with today’s technology, to tell that software is error free and has not been tampered 
with. Many of them recommend that electronic voting machines should be complemented 
by a voter verifiable audit trail. (A good source of information is [1].) Typically, a voter- 
verifiable machine prints out the choices that are being tallied. Each voter has a chance to 
review the printout, and then deposits it in an old-fashioned ballot box. If there is a problem 
with the electronic equipment, the printouts can be counted by hand. 

As this book is written, this concept is strongly resisted both by manufacturers of elec- 
tronic voting machines and by their customers, the cities and counties that run elections. 
Manufacturers are reluctant to increase the cost of the machines because they may not be 
able to pass the cost increase on to their customers, who tend to have tight budgets. Election 
officials fear problems with malfunctioning printers, and some of them have publicly stated 
that they actually prefer equipment that eliminates bothersome recounts. 

What do you think? You probably use an automatic bank teller machine to get cash from 
your bank account. Do you review the paper record that the machine issues? Do you check 
your bank statement? Even if you don’t, do you put your faith in other people who double- 
check their balances, so that the bank won’t get away with widespread cheating? 

At any rate, is the integrity of banking equipment more important or less important than 
that of voting machines? Won’t every voting process have some room for error and fraud 
anyway? Is the added cost for equipment, paper, and staff time reasonable to combat a 
potentially slight risk of malfunction and fraud? Computer scientists cannot answer these 


112 CHAPTER 3 &® Implementing Classes GRAPHICS TRACK 


Touch Screen Voting Machine 


questions —an informed society must make these tradeoffs. But, like all professionals, they 
have an obligation to speak out and give accurate testimony about the capabilities and limita- 
tions of computing equipment. 


We continue the optional graphics track by discussing how to organize complex 
drawings in a more object-oriented fashion. Feel free to skip this section if you are 
not eds in graphical applications. 

uae When you produce a drawing that is composed of complex parts, 
such as the one in Figure 9, it is a good idea to make a separate class 
for each part. Provide a draw method that draws the shape, and pro- 
vide a constructor to set the position of the shape. For example, here 
is the outline of the Car class. 


public class Car 


public CarCint x, int y) 
// Remember position 
$ 
public void draw(Graphics2D g2) 
// Drawing instructions 
} 


on 


lex shape, make a 
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Figure 9 


The Car Component Draws Two Car Shapes 


gure out how to draw © 


graph paper. _ 


You will find the complete class definition at the end of this section. 
The draw method contains a rather long sequence of instructions for 
drawing the body, roof, and tires. 

The coordinates of the car parts seem a bit arbitrary. To come up 
with suitable values, draw the image on graph paper and read off the 


coordinates (Figure 10). 
The program that produces Figure 9 is composed of three classes. 


10 


2 


30 


40 


Fi 


10 20 30 40 50 60 


ZN 
CPT 

onnen 
ann 


gure 10 Using Graph Paper to Find Shape Coordinates 
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e The Car class is responsible for drawing a single car. Two objects of this class are 
constructed, one for each car. 


e The CarComponent class displays the drawing. 


e The CarViewer class shows a frame that contains a CarComponent. 


Let us look more closely at the CarComponent class. The paintComponent method 
draws two cars. We place one car in the top-left corner of the window, and the other 
car in the bottom right. To compute the bottom right position, we call the getWidth 
and getHeight methods of the JComponent class. These methods return the dimen- 
sions of the component. We subtract the dimensions of the car: 


Car carl = new Car(O, 0); 


int x = getWidthQ® - 60; 
int y = getHeight() - 30; 
Car car2 = new Car(x, y); 


Pay close attention to the call to getWidth inside the paintComponent method of 
CarComponent. The method call has no implicit parameter, which means that the 
method is applied to the same object that executes the paintComponent method. The 
component simply obtains its own width. 

Run the program and resize the window. Note that the second car always ends 
up at the bottom-right corner of the window. Whenever the window is resized, the 
paintComponent method is called and the car position is recomputed, taking the cur- 
rent component dimensions into account. 


ch03/car/CarComponent.java 


1 import java.awt.Graphics; 
2 import java.awt.Graphics2D; 
3 import javax.swing.JComponent; 
4 
5 
6 This component draws two car shapes. 
7 * 
8 public class CarComponent extends JComponent 
9 { 
10 public void paintComponent(Graphics g) 
11 { 
iz Graphics2D g2 = (Graphics2D) g; 
13 
14 Car carl = new Car(0, 9); 
15 
16 int x = getWidthQ - 69; 
17 int y = getHeightQ - 39; 
18 
19 Car car2 = new Car(x, y); 
20 
21 carl.draw(g2); 
22 car2.draw(g2); 
Zs } 
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ch03/car/Car.java 


1 import java.awt.Graphics2D; 

2 import java.awt.Rectangle; 

3 import java.awt.geom.E1llipse2D; 
4 import java.awt.geom.Line2D; 

5 import java.awt.geom.Point2D; 
6 

7 

8 


/* te 
A car shape that can be positioned anywhere on the screen. 
9 */ 

10 public class Car 
a1. 4 
iz [ee 
13 Constructs a car with a given top-left corner. 
14 @param x the x-coordinate of the top-left corner 
15 @param y the y-coordinate of the top-left corner 
16 * / 
17 public Car(Cint x, int y) 
18 { 
19 xLeft = x; 
20 yTop = y; 
21 } 
22 
23 [we 
24 Draws the car. 
25 @param g2 the graphics context 
26 * / 
ZT public void draw(Graphics2D g2) 
28 { 
29 Rectangle body 
30 = new Rectangle(xLeft, yTop + 19, 60, 10); 
31 Ellipse2D.Double frontTire 
32 = new Ellipse2D.Double(xLeft + 10, yTop + 20, 19, 19); 
33 Ellipse2D.Double rearTire 
34 = new Ellipse2D.Double(xLeft + 40, yTop + 20, 10, 19); 
35 
36 // The bottom of the front windshield 
37 Point2D.Double rl 
38 = new Point2D.Double(xLeft + 19, yTop + 10); 
39 // The front of the roof 
40 Point2D.Double r2 
41 = new Point2D.Double(xLeft + 20, yTop); 
42 // The rear of the roof 
43 Point2D.Double r3 
aa = new Point2D.Double(xLeft + 40, yTop); 
45 // The bottom of the rear windshield 
46 Point2D.Double r4 
47 = new Point2D.Double(xLeft + 50, yTop + 19); 
48 
49 Line2D.Double frontWindshield 
50 = new Line2D.Double(rl1, r2); 
51 Line2D.Double roofTop 


oe 4 = new Line2D.Double(r2, r3); 
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53 Line2D.Double rearWindshield 
54 = new Line2D.Double(r3, r4); 
55 

56 g2.draw(body) ; 

57 g2.draw(frontTire) ; 

58 g2.draw(rearTire) ; 

59 g2.draw(frontWindshield) ; 
60 g2.draw(roofTop) ; 

61 g2.draw(rearWindshield) ; 

62 

63 

64 private int xLeft; 

65 private int yTop; 

66 


ch03/car/CarViewer.java 


import javax.swing. JFrame; 


2 

3 public class CarViewer 

4 

5 public static void main(String[] args) 

6 

7 Frame frame = new JFrameQ); 

8 

rame.setSize(300, 400); 

10 rame.setlTitle("Two cars"); 
11 rame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
iz 

13 arComponent component = new CarComponent() ; 
14 frame.add(component) ; 
15 

16 frame.setVisible(true) ; 

i? 

18 
SELF CHECK 


. Which class needs to be modified to have the two cars positioned next to each 
other? 


19. Which class needs to be modified to have the car tires painted in black, and 
what modification do you need to make? 


20. How do you make the cars twice as big? 
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How To 3.2 


Drawing Graphical Shapes 


You can write programs that display a wide variety of graphical shapes. These instructions 
give you a step-by-step procedure for decomposing a drawing into parts and implementing a 
program that produces the drawing. 


Step 1 Determine the shapes that you need for the drawing. 


You can use the following shapes: 
¢ Squares and rectangles 

* Circles and ellipses 

¢ Lines 


The outlines of these shapes can be drawn in any color, and you can fill the insides of these 
shapes with any color. You can also use text to label parts of your drawing. 


Some national flag designs consist of three equally wide sections of different colors, side 
by side: 


You could draw such a flag using three rectangles. But if the middle rectangle is white, as it is, 
for example, in the flag of Italy (green, white, red), it is easier and looks better to draw a line 
on the top and bottom of the middle portion: 


Two lines 


Two rectangles 


Step 2 Find the coordinates for the shapes. 


You now need to find the exact positions for the geometric shapes. 
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e For rectangles, you need the x- and y-position of the top-left corner, the width, and the 
height. 


e For ellipses, you need the top-left corner, width, and height of the bounding rectangle. 
e For lines, you need the x- and y-positions of the starting point and the end point. 
e For text, you need the x- and y-positions of the basepoint. 


A commonly-used size for a window is 300 by 300 pixels. You may not want the flag crammed 
all the way to the top, so perhaps the upper-left corner of the flag should be at point (100, 100). 

Many flags, such as the flag of Italy, have a width : height ratio of 3 : 2. (You can often find 
exact proportions for a particular flag by doing a bit of Internet research on one of several 
Flags of the World sites.) For example, if you make the flag 90 pixels wide, then it should be 
60 pixels tall. (Why not make it 100 pixels wide? Then the height would be 100 - 2 / 3 = 67, 
which seems more awkward.) 

Now you can compute the coordinates of all the important points of the shape: 


(100, 100) (130, 100) (160, 100) (190, 100) 


(100, 160) (130, 160) (160, 160) (190, 160) 


Step 3. Write Java statements to draw the shapes. 


In our example, there are two rectangles and two lines: 


Rectangle leftRectangle 

= new Rectangle(100, 100, 30, 60); 
Rectangle rightRectangle 

= new Rectangle(160, 100, 30, 60); 
Line2D.Double topLine 

= new Line2D.Double(130, 100, 160, 100); 
Line2D.Double bottomLine 

= new Line2D.Double(130, 160, 160, 160); 


If you are more ambitious, then you can express the coordinates in terms of a few variables. 
In the case of the flag, we have arbitrarily chosen the top-left corner and the width. All other 
coordinates follow from those choices. If you decide to follow the ambitious approach, then 
the rectangles and lines are determined as follows: 


Rectangle leftRectangle = new Rectangle( 
xLeft, yTop, 
width / 3, width * 2 / 3); 
Rectangle rightRectangle = new Rectangle( 
xLeft + 2 * width / 3, yTop, 
width / 3, width * 2 / 3); 
Line2D.Double topLine = new Line2D.Double( 
xLeft + width / 3, yTop, 
xLeft + width * 2 / 3, yTop); 
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Line2D.Double bottomLine = new Line2D.Double( 
xLeft + width / 3, yTop + width * 2 / 3, 
xLeft + width * 2 / 3, yTop + width * 2 / 3); 


Now you need to fill the rectangles and draw the lines. For the flag of Italy, the left rectangle 
is green and the right rectangle is red. Remember to switch colors before the filling and 
drawing operations: 


g2.setColor(Color.GREEN) ; 
g2.fillCleftRectangle) ; 
g2.setColor(Color.RED) ; 
g2.fillCrightRectangle) ; 
g2.setColor(Color.BLACkK) ; 
g2.draw(topLine) ; 
g2.draw(bottomLine) ; 


Step 4. Combine the drawing statements with the component “plumbing”. 


public class MyComponent extends JComponent 
public void paintComponent(Graphics g) 


Graphics2D g2 = (Graphics2D) g; 
/ Your drawing code goes here 


In our example, you can simply add all shapes and drawing instructions inside the paint- 
Component method: 


public class ItalianFlagComponent extends JComponent 
public void paintComponent(Graphics g) 


Graphics2D g2 = (Graphics2D) g; 
Rectangle leftRectangle 
= new Rectangle(100, 100, 30, 60); 


g2.setColor(Color.GREEN) ; 
g2.fillCleftRectangle); 


That approach is acceptable for simple drawings, but it is not very object-oriented. After all, 
a flag is an object. It is better to make a separate class for the flag. Then you can draw differ- 
ent flags at different positions and sizes. Specify the sizes in a constructor and supply a draw 
method: 


public class ItalianFlag 


public ItalianFlag(double x, double y, double aWidth) 
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} 
public void draw(Graphics2D g2) 
{ 
Rectangle leftRectangle = new Rectangle( 
xLeft, yTop, 
width / 3, width * 2 / 3); 
g2.setColor(Color.GREEN) ; 
g2.fillCleftRectangle) ; 
} 


private int xLeft; 
private int yTop; 
private double width; 


} 


You still need a separate class for the component, but it is very simple: 


public class ItalianFlagComponent extends JComponent 


{ 
public void paintComponent(Graphics g) 
{ 
Graphics2D g2 = (Graphics2D) g; 
ItalianFlag flag = new ItalianFlag(100, 100, 90); 
flag.draw(g2); 
; 
} 


Step 5 Write the viewer class. 


Provide a viewer class, with a main method in which you construct a frame, add your compo- 
nent, and make your frame visible. The viewer class is completely routine; you only need to 
change a single line to show a different component. 


import javax.swing.*; 


public class ItalianFlagViewer 


{ 


public static void main(String[] args) 


{ 


JFrame frame 


new JFrame(); 


frame.setSize(300, 400); 
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 


ItalianFlagComponent component = new ItalianFlagComponent() ; 
frame.add(component) ; 


frame.setVisible(true); 
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RANDOM FACT 3.2 


Computer Graphics 


Generating and manipulating visual images is one of the most exciting applications of the 
computer. We distinguish different kinds of graphics. 

Diagrams, such as numeric charts or maps, are artifacts that convey information to the 
viewer (see Diagrams figure). They do not directly depict anything that occurs in the natural 
world, but are a tool for visualizing information. 

Scenes are computer-generated images that attempt to depict images of the real or an 
imagined world (see Scene figure). It turns out to be quite challenging to render light and 
shadows accurately. Special effort must be taken so that the images do not look too neat and 
simple; clouds, rocks, leaves, and dust in the real world have a complex and somewhat ran- 
dom appearance. The degree of realism in these images is constantly improving. 

Manipulated images are photographs or film footage of actual events that have been con- 
verted to digital form and edited by the computer (see Manipulated Image figure). For exam- 
ple, film sequences in the movie Apollo 13 were produced by starting from actual images and 
changing the perspective, showing the launch of the rocket from a more dramatic viewpoint. 

Computer graphics is one of the most challenging fields in computer science. It requires 
processing of massive amounts of information at very high speed. New algorithms are con- 
stantly invented for this purpose. Displaying an overlapping set of three-dimensional objects 
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Scene 


Manipulated Image 


with curved boundaries requires advanced mathematical tools. Realistic modeling of textures 
and biological entities requires extensive knowledge of mathematics, physics, and biology. 


| 
| 
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1. 


13. 


14. 


15. 


16. 


17. 


18. 


19. 


In order to implement a class, you first need to know which methods are 
required. 


A method definition contains an access specifier (usually public), a return type, 
a method name, parameters, and the method body. 


Constructors contain instructions to initialize objects. The constructor name is 
always the same as the class name. 


. Use documentation comments to describe the classes and public methods of 


your programs. 


Provide documentation comments for every class, every method, every parame- 
ter, and every return value. 


An object uses instance fields to store its state—the data that it needs to execute 
its methods. 


Each object of a class has its own set of instance fields. 
You should declare all instance fields as private. 


Encapsulation is the process of hiding object data and providing methods for 
data access. 


Constructors contain instructions to initialize the instance fields of an object. 
Use the return statement to specify the value that a method returns to its caller. 


A unit test verifies that a class works correctly in isolation, outside a complete 
program. 


To test a class, use an environment for interactive testing, or write a tester class 
to execute test instructions. 


Instance fields belong to an object. Parameter variables and local variables 
belong to a method—they die when the method exits. 


Instance fields are initialized to a default value, but you must initialize local 
variables. 


The implicit parameter of a method 1s the object on which the method 1s 
invoked. The this reference denotes the implicit parameter. 


Use of an instance field name in a method denotes the instance field of the 
implicit parameter. 


It is a good idea to make a class for any part of a drawing that that can occur 
more than once. 


To figure out how to draw a complex shape, make a sketch on graph paper. 


124 


xk 


od 
x 


CHAPTER3 ® Implementing Classes 


FURTHER READING 


1. http://verifiedvoting.org A site with information on voter-verifiable voting 
machines, founded by Stanford computer science professor David Dill. 


REVIEW EXERCISES 


Exercise R3.1. Why is the BankAccount(double initialBalance) constructor not 
strictly necessary? 
Exercise R3.2. Explain the difference between 
BankAccount b; 
and 


BankAccount b = new BankAccount(5000) ; 


Exercise R3.3. Explain the difference between 
new BankAccount (5000) ; 

and 
BankAccount b = new BankAccount(5000) ; 


Exercise R3.4. What happens in our implementation of the BankAccount class when 
more money is withdrawn from the account than the current balance? 


Exercise R3.5. What is the value returned from the method call b.getBalance() after 
the following operations? 
BankAccount b = new BankAccount(10) ; 


b.deposit(5000) ; 
b.withdraw(b.getBalance() / 2); 


Exercise R3.6. If b1 and b2 refer to objects of class BankAccount, consider the follow- 
ing instructions. 


b1.deposit(b2.getBalance()); 
b2.deposit(b1.getBalance()); 


Are the balances of b1 and b2 now identical? Explain. 
Exercise R3.7. What is the this reference? Why would you use it? 


Exercise R38. What does the following method do? Give an example of how you can 
call the method. 


public class BankAccount 
{ 
public void mystery(BankAccount that, double amount) 
‘ 
this.balance - amount; 
that.balance + amount; 


this.balance 
that.balance 
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. // Other bank account methods 
} 


— Suppose you want to implement a class TimeDepositAccount. A time 
depositaccount has a fixed interest rate that should be set in the constructor, 
together with the initial balance. Provide a method to get the current balance. Pro- 
vide a method to add the earned interest to the account. This method should have 
no parameters because the interest rate is already known. It should have no return 
value because you already provided a method for obtaining the current balance. It 1s 
not possible to deposit additional funds into this account. Provide a withdraw 
method that removes the entire balance. Partial withdrawals are not allowed. 


Exercise R3.40. What are the accessors and mutators of the CashRegister class? 


Exercise R3.11. Explain the difference between a local variable and a parameter 
variable. “ 


Exercise R3.12. Explain the difference between an instance field and a local variable. 


Exercise R3.13. Suppose you want to extend the car viewer program in Section 3.9 to 
show a suburban scene, with several cars and houses. Which classes do you need? 


Exercise R3.14. Explain why the calls to the getwidth and getHeight methods in the 
CarComponent class have no explicit parameter. 


Exercise R3.15. How would you modify the Car class in order to show cars of vary- 
ing sizes? 


Additional review exercises are available in WileyPLUS. 


PROGRAMMING EXERCISES _ 


Exercise P34. Write a BankAccountTester class whose main method constructs a bank 
account, deposits $1,000, withdraws $500, withdraws another $400, and then prints 
the aes balance. Also print the expected result. 


To “> A 


Exercise P32. Addamethod ww "S.4. 
public void addInterest(double rate) 


to the BankAccount class that adds interest at the given rate. For example, after the 
statements 


BankAccount momsSavings = new BankAccount (1000) ; 
momsSavings.addInterest(10); // 10% interest 


the balance in momsSavings is $1,100. Also supply a BankAccountTester class that 
prints the actual and expected balance. 
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Exercise P3.3. Write a class SavingsAccount that is similar to the BankAccount class, 
except that it has an added instance field interest. Supply a constructor that sets 
both the initial balance and the interest rate. Supply a method addInterest (with no 
explicit parameter) that adds interest to the account. Write a SavingsAccountTester 
class that constructs a savings account with an initial balance of $1,000 and an 
interest rate of 10%. Then apply the addInterest method and print the resulting 
balance. Also compute the expected result by hand and print it. 


Exercise P3.4. Implement a class Employee. An employee has a name (a string) and a 
salary (a double). Provide a constructor with two parameters 


public Employee(String employeeName, double currentSalary) 
and methods 


public String getName() 
public double getSalary( 
public void raiseSalary(double byPercent) 


These methods return the name and salary, and raise the employee’s salary by a cer- 
tain percentage. Sample usage: 


Employee harry = new Employee("Hacker, Harry", 50000); 
harry.raiseSalary(10); // Harry gets a 10% raise 


Supply an EmployeeTester class that tests all methods. 


Exercise P3.5. Implement a class Car with the following properties. A car has a cer- 
tain fuel efficiency (measured in miles/gallon or liters/km— pick one) and a certain 
amount of fuel in the gas tank. The efficiency is specified in the constructor, and the 
initial fuel level is 0. Supply a method drive that simulates driving the car for a 
certain distance, reducing the amount of gasoline in the fuel tank. Also supply 
methods getGasInTank, returning the current amount of gasoline in the fuel tank, 
and addGas, to add gasoline to the fuel tank. Sample usage: 


Car myHybrid = new Car(50); // 50 miles per gallon 

myHybrid.addGas(20); // Tank 20 gallons 

myHybrid.drive(100); // Drive 100 miles 

double gasLeft = myHybrid.getGasInTank(); // Get gas remaining in tank 
You may assume that the drive method is never called with a distance that con- 
sumes more than the available gas. Supply a CarTester class that tests all methods. 


Exercise P3.6. Implement a class Student. For the purpose of this exercise, a student 
has a name and a total quiz score. Supply an appropriate constructor and methods 
getName(), addQuiz(Cint score), getTotalScore(), and getAverageScore(). To com- 

pute the latter, you also need to store the number of quizzes that the student took. 


Supply a StudentTester class that tests all methods. 


Exercise P3.7. Implement a class Product. A product has a name and a price, for 
example new Product("Toaster", 29.95). Supply methods getName, getPrice, and 
reducePrice. Supply a program ProductPrinter that makes two products, prints the 
name and price, reduces their prices by $5.00, and then prints the prices again. 
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Exercise P3.8. Provide a class for authoring a simple letter. In the constructor, supply 
the names of the sender and the recipient: 


public Letter(String from, String to) 
Supply a method 
public void addLine(String line) 
to add a line of text to the body of the letter. 
Supply a method 
public String getText() 
that returns the entire text of the letter. The text has the form: 


Dear recipient name : 
blank line 

first line of the body 
second line of the body 


last line of the body 
blank line 
Sincerely, 
blank line 


sender name 
Also supply a program LetterPrinter that prints this letter. 
Dear John: 


I am sorry we must part. 
I wish you all the best. 


Sincerely, 


Mary 
Construct an object of the Letter class and call addLine twice. 


Hints: (1) Use the concat method to form a longer string from two shorter strings. 
(2) The special string "\n" represents a new line. For example, the statement 


body = body.concatC("Sincerely,").concat("\n") ; 
adds a line containing the string "Sincerely," to the body. 
Exercise P3.9. Write a class Bug that models a bug moving along a horizontal line. 
The bug moves either to the right or left. Initially, the bug moves to the right, but it 


can turn to change its direction. In each move, its position changes by one unit in 
the current direction. Provide a constructor 


public Bug(int initialPosition) 
and methods 


public void turn() 
public void move() 
public int getPosition() 
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Sample usage: 


Bug bugsy = new Bug(10); 

bugsy.move(); // now the position is 11 

bugsy.turn(); 

bugsy.move(); // now the position is 10 
Your BugTester should construct a bug, make it move and turn a few times, and 
print the actual and expected position. 


Exercise P3.10. Implement a class Moth that models a moth flying across a straight 
line. The moth has a position, the distance from a fixed origin. When the moth 
moves toward a point of light, its new position is halfway between its old position 
and the position of the light source. Supply a constructor 


public Moth(double initialPosition) 
and methods 


public void moveToLight(double lightPosition) 

public void getPosition() 
Your MothTester should construct a moth, move it toward a couple of light sources, 
and check that the moth’s position is as expected. 


Exercise P3.11. Implement a class RoachPopulation that simulates the growth of a 
roach population. The constructor takes the size of the initial roach population. The 
breed method simulates a period in which the roaches breed, which doubles their 
population. The spray method simulates spraying with insecticide, which reduces 
the population by 10%. The getRoaches method returns the current number of 
roaches. A program called RoachSimulation simulates a population that starts out 
with 10 roaches. Breed, spray, and print the roach count. Repeat three more times. 


Exercise P3.12. Implement a VotingMachine class that can be used for a simple elec- 
tion. Have methods to clear the machine state, to vote for a Democrat, to vote for a 
Republican, and to get the tallies for both parties. Extra credit if your program gives 
the nod to your favored party if the votes are tallied after 8 p.m. on the first Tuesday 
in November, but acts normally on all other dates. (Hint: Use the Gregorian- 
Calendar class—see Programming Project 2.1.) 


Exercise P3.13. Draw a “bull’s eye” —a set of concentric rings in alternating black and 
white colors. Hint: Fill a black circle, then fill a smaller white circle on top, and so on. 


Your program should be composed of classes BullsEye, Bull sEyeComponent, and 
Bul lsEyeViewer. 
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Exercise P3.14. Write a program that draws a picture of a house. It could be as simple 
as the accompanying figure, or if you like, make it more elaborate (3-D, skyscraper, 
marble columns in the entryway, whatever). 


Implement a class House and supply a method draw(Graphics2D g2) that draws the 
house. 


Exercise P3.15. Extend Exercise P3.14 by supplying a House constructor for specify- 
ing the position and size. Then populate your screen with a few houses of different 
SIZeS. 


Exercise P3.16. Change the car viewer program in Section 3.9 to make the cars 
appear in different colors. Each Car object should store its own color. Supply 
modified Car and CarComponent classes. 


Exercise P3.17. Change the Car class so that the size of a car can be specified in the 
constructor. Change the CarComponent class to make one of the cars appear twice the 
size of the original example. 


Exercise P3.18. Write a program to plot the string “HELLO, using only lines and 
circles. Do not call drawString, and do not use System.out. Make classes Letterh, 
LetterE, LetterL, and LetterO. 


Exercise P3.19. Write a program that displays the Olympic rings. Color the rings in 
the Olympic colors. 


Provide a class OlympicRingViewer and a class OlympicRingComponent. 


Exercise P3.20. Make a bar chart to plot the following data set. Label each bar. Make 
the bars horizontal for easier labeling. Provide a class BarChartViewer and a class 
BarChartComponent. 


Bridge Name Longest Span (ft) 


Golden Gate 4,200 
Brooklyn 1,595 
Delaware Memorial 2,150 


Mackinac 3,800 
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Additional programming exercises are available in WileyPLUS. 
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Project 3.1. In this project, you will enhance the BankAccount class and see how 
abstraction and encapsulation enable evolutionary changes to software. 


Begin with a simple enhancement: charging a fee for every deposit and withdrawal. 
Supply a mechanism for setting the fee and modify the deposit and withdraw meth- 
ods so that the fee is levied. Test your resulting class and check that the fee is com- 
puted correctly. 


Now make a more complex change. The bank will allow a fixed number of free 
transactions (deposits or withdrawals) every month, and charge for transactions 
exceeding the free allotment. The charge is not levied immediately but at the end of 
the month. 


Supply a new method deductMonthlyCharge to the BankAccount class that deducts the 
monthly charge and resets the transaction count. Produce a test program that veri- 
fies that the fees are calculated correctly over several months. 


Project 3.2. In this project, you will explore an object-oriented alternative to the 
“Hello, World” program in Chapter 1. 


Begin with a simple Greeter class that has a single method, sayHel1o. That method 
should return a string, not print it. Use BlueJ to create two objects of this class and 
invoke their sayHello methods. 


That is boring —of course, both objects return the same answer. 


Enhance the Greeter class so that each object produces a customized greeting. For 
example, the object constructed as new Greeter("Dave") should say "Hello, Dave". 
(Use the concat method to combine strings to form a longer string, or peek ahead at 
Section 4.6 to see how you can use the + operator for the same purpose.) 


Add a method sayGoodbye to the Greeter class. 


Finally, add a method refuseHe1p to the Greeter class. It should return a string such 
as "I am sorry, Dave. I am afraid I can't do that." 


Test your class in BlueJ. Make objects that greet the world and Dave, and invoke 
methods on them. 
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. The programmers who designed and implemented the Java library. 
. Other programmers who work on the personal finance application. 
. harrysChecking.withdrawC(harrysChecking.getBalance() ) 


. Add an accountNumber parameter to the constructors, and adda getAccount- 


Number method. There is no need for a setAccountNumber method —the account 
number never changes after construction. 


Faas * 
Constructs a new bank account with a given initial balance. 
@param accountNumber the account number for this account 
@param initialBalance the initial balance for this account 


ay 

The first sentence of the method description should describe the method —it 1s 
displayed in isolation in the summary table. 

An instance field 

private int accountNumber ; 

needs to be added to the class. 

There are four fields: x, y, width, height. All four fields have type int. 


public int getWidth() 
{ 

return width; 
} 


There is more than one correct answer. One possible implementation 1s as 
follows: 


public void translate(int dx, int dy) 


{ 
int newx = x + dx; 
xX = newx; 
int newy = y + dy; 
y = newy; 

$ 


One BankAccount object, no BankAccountTester object. The purpose of the 
BankAccountTester class is merely to hold the main method. 


In those environments, you can issue interactive commands to construct 
BankAccount objects, invoke methods, and display their return values. 


Variables of both categories belong to methods—they come alive when the 
method is called, and they die when the method exits. They differ in their ini- 
tialization. Parameter variables are initialized with the call values; local variables 
must be explicitly initialized. 


One instance field, named balance. Three local variables, one named 
harrysChecking and two named newBalance (in the deposit and withdraw 
methods); two parameter variables, both named amount (in the deposit and 
withdraw methods). 
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15. 


16. 


17. 


18. 


19. 


20. 


One implicit parameter, called this, of type BankAccount, and one explicit 
parameter, called amount, of type double. 


It is not a legal expression. this is of type BankAccount and the BankAccount class 
has no field named amount. 


No implicit parameter —the method is static—and one explicit parameter, called 
args. 


CarComponent 
In the draw method of the Car class, call 


g2.fi11(frontTire) ; 
g2.fillCrearTire); 


Double all measurements in the draw method of the Car class. 
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© Io understand integer and floating-point numbers 


oe recognize the limitations of the numeric types 


To become aware of causes for overflow and roundoff errors: 


e proper use of constants 


To write arithmetic expressions in Java 


: As use ‘the Str ng type to define and manipulate 
. character strings 


. To learn how to read program input and produce 
formatted output — 


This chapter teaches how to manipulate numbers and character strings in Java. The 
goal of this chapter is to gain a firm understanding of the fundamental Java data 
types. 

You will learn about the properties and limitations of the number types in Java. 
You will see how to manipulate numbers and strings in your programs. Finally, we 
cover the important topic of input and output, which enables you to implement 


interactive programs. 
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In Java, every value is either a reference to an object, or it belongs to 
one of the eight primitive types shown in Table 1. 

Six of the primitive types are number types, four of them for inte- 
gers and two for floating-point numbers. 

Each of the integer types has a different range—Advanced Topic 
4.2 explains why the range limits are related to powers of two. Gen- 
erally, you will use the int type for integer quantities. However, 
occasionally, calculations involving integers can overflow. This hap- 
pens if the result of a computation exceeds the range for the number 
type. For example: 

int n = 1000000; 

System.out. printIn(n * ny); // Prints -727379968 
o-. 


The product n * n is 10°°, which is larger than the largest i integer (about 2 - 10”). 
The result is truncated to fit into an 4 nt, yielding a value that is completely wrong. 
Unfortunately, there is no warning wien on integer overflow occurs. 
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Table 1 Primitive Types 


Type : Description Size 
int The integer type, with range —2,147,483,648 ... 2,147,483,647 4 bytes 
: 7 (about 2 billion) 
byte The type describing a single byte, with range -128 ... 127 1 byte 
short The short integer type, with range -32768...32767 2 bytes 
long The long integer type, with range 8 bytes 


—9,223,372,036,854,775,808 . .. 9,223,372,036,854,7 75,807 


double The double-precision floating-point type, with a range of 8 bytes 
| about +10°°8 and about 15 significant decimal digits 


: fl Oat The single-precision floating-point type, with a range of 4 bytes 
iL about +10°° and about 7 significant decimal digits _ 


char The character type, representing code units in the 2 bytes 
. Unicode encoding scheme (see Advanced Topic 4.5) 


boolean The type with the two truth values false and true (see Chapter 5) — 1 bit 


If you run into this problem, the simplest remedy is to use the long type. 
Advanced Topic 4.1 shows you how to use the arbitary-precision BigInteger type 
in the unlikely event that even the long type overflows. 

Overflow is not usually a problem for double-precision floating-point numbers. 
The double type has a range of about +10°°° and about 15 significant digits. How- 
ever, you want to avoid the float type—it has less than 7 significant digits. (Some 
programmers use float to save on memory if they need to store a huge set of num- 
bers that do not require much precision.) 

me Rounding errors are a more serious issue with floating-point val- 
ues. Rounding errors can occur when you convert between binary 
and decimal numbers, or between integers and floating-point num- 
bers. When a value cannot be converted exactly, it is rounded to the 
nearest match. Consider this example: 


double f = 4.35; 
System.out.printIn(100 * f); // Prints 434.99999999999994 


This problem is caused because computers represent numbers in the binary number 
system. In the binary number system, there is no exact representation of the frac- 
tion 1/10, just as there is no exact representation of the fraction 1/3 = 0.33333 in the 
decimal number system. (See Advanced Topic 4.2 for more information.) 

For this reason, the double type is not appropriate for financial calculations. In 
this book, we will continue to use double values for bank balances and other finan- 
cial quantities so that we keep our programs as simple as possible. However, 


136 


CHAPTER4 #® Fundamental Data Types 


professional programs need to use the BigDecimal type for this purpose—see 
Advanced Topic 4.1. 


In Java, it is legal to assign an integer value to a floating-point variable: 


int dollars = 100; 
double balance = dollars; //OK 


But the opposite assignment is an error: You cannot assign a floating-point expres- 
sion to an integer variable. 


double balance = 13.75; 
int dollars = balance; // Error 


To overcome this problem, you can convert the floating-point value to an integer 
with a cast: 


int dollars = Cint) balance; 


The cast (int) converts the floating-point value balance to an integer 
by discarding the fractional part. For example, if balance is 13.75, 
then dollars is set to 13. 

The cast tells the compiler that you agree to information loss, in 
this case, to the loss of the fractional part. You can also cast to other 
types, such as (float) or (byte). | 

If you want to round a floating-point number to the nearest whole 
number, use the Math. round method. This method returns a long inte- 
ger, because large floating-point numbers cannot be stored in an int. 


long rounded = Math. round(balance) ; 


If balance is 13.75, then rounded is set to 14. 


SYNTAX 4.1 Cast 


(typeName) expression 


Example: 
Cint) Cbalance * 100) 


Purpose: 


To convert an expression to a different type 


SELF CHECK 


1. Which are the most commonly used number types in Java? 


2. When does the cast (long) x yield a different result from the call 
Math. round(x) ? 


3. How do you round the double value x to the nearest int value, assuming that 
you know that it is less than 2 - 107? 
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ADVANCED TOPIC 4.1 


Big Numbers 


If you want to compute with really large numbers, you can use big number objects. Big 
number objects are objects of the BigInteger and BigDecimal classes in the java.math pack- 
age. Unlike the number types such as int or double, big number objects have essentially no 
limits on their size and precision. However, computations with big number objects are much 
slower than those that involve number types. Perhaps more importantly, you can’t use the 
familiar arithmetic operators such as (+ - *) with them. Instead, you have to use methods 
called add, subtract, and multiply. Here is an example of how to create two big integers and 
how to multiply them. 


BigInteger a = new BigInteger("1234567890") ; 
BigInteger b = new BigInteger('"9876543210") ; 
BigInteger c = a.multiply(b); 

System.out.printIn(c); // Prints 12193263111263526900 


The BigDecimal type carries out floating-point computation without roundoff errors. For 
example, 


BigDecimal d = new BigDecimal ("4.35"); 
BigDecimal e = new BigDecimal ("100") ; 
BigDecimal f = d.multiply(Ce); 

System.out.printin(f); // Prints 435.00 


ADVANCED ToPICc 4.2 
Binary Numbers 


You are familiar with decimal numbers, which use the digits 0, 1, 2,..., 9. Each digit has a 
place value of 1, 10, 100 = 107, 1000 = 10°, and so on. For example, 


435=4-107+3-10!+5-10° 


Fractional digits have place values with negative powers of ten: 0.1 = 107!, 0.01 = 107%, and so 
on. For example, 


4.35=4-10°+3-10!45-107 


Computers use binary numbers instead, which have just two digits (0 and 1) and place values 
that are powers of 2. Binary numbers are easier for computers to manipulate, because it is 
easier to build logic circuits that differentiate between “off” and “on” than it is to build cir- 
cuits that can accurately tell ten different voltage levels apart. 

It is easy to transform a binary number into a decimal number. Just compute the powers 
of two that correspond to ones in the binary number. For example, 


1101 binary = 1-2? 4+1-27+0-2'41-2°=84+44+1=13 
Fractional binary numbers use negative powers of two. For example, 


1.101 binary =1-294+1-2740-2741-2°=14+0.5 40.125 = 1.625 
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Converting decimal numbers to binary numbers is a little trickier. Here is an algorithm that 
converts a decimal integer into its binary equivalent: Keep dividing the integer by 2, keeping 
track of the remainders. Stop when the number is 0. Then write the remainders as a binary 
number, starting with the last one. For example, 


100+2 = 50 remainder 0 
50 +2 = 25 remainder 0 
25+2 = 12 remainder 1 
12+2 = 6 remainder 0 


6+2 = 3 remainder 0 


3+2 = 1 remainder 1 
1 +2 = O remainder 1 


Therefore, 100 in decimal is 1100100 in binary. 

To convert a fractional number <1 to its binary format, keep multiplying by 2. If the 
result is >1, subtract 1. Stop when the number is 0. Then use the digits before the decimal 
points as the binary digits of the fractional part, starting with the first one. For example, 


0.35-2 = 0.7 
07-2 = 1.4 
04-2 = 0.8 
08-2 = 1.6 
06-2 = 12 
02-2 = 0.4 


Here the pattern repeats. That is, the binary representation of 0.35 is 0.01 011001100110... 

To convert any floating-point number into binary, convert the whole part and the frac- 
tional part separately. For example, 4.35 is 100.01 0110 0110 0110... in binary. 

You don’t actually need to know about binary numbers to program in Java, but at times it 
can be helpful to understand a little about them. For example, knowing that an int is repre- 
sented as a 32-bit binary number explains why the largest integer that you can represent in 
Java is O111 1111 1111 1111 1111 1111 1111 1111 binary = 2,147,483,647 decimal. (The first 
bit is the sign bit. It is off for positive values.) 

To convert an integer into its binary representation, you can use the static toString 
method of the Integer class. The call Integer.toString(n, 2) returns a string with the 
binary digits of the integer n. Conversely, you can convert a string containing binary digits 
into an integer with the call Integer.parseInt(digitString, 2). In both of these method 
calls, the second parameter denotes the base of the number system. It can be any number 
between 0 and 36. You can use these two methods to convert between decimal and binary 
integers. However, the Java library has no convenient method to do the same for floating- 
point numbers. 

Now you can see why we had to fight with a roundoff error when computing 100 times 
4.35. If you actually carry out the long multiplication, you get: 
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LIO0OOoOLOVOF LOOOLTOLLOOLLO0OLIO... 


100.01/0110j0110j0110... 
100.01/0110j0110j011 
0 
0 
100.01j0110j0110... 
0 
0 


LiQidt 00 20.12.2042. 04 2d dea 


That is, the result is 434, followed by an infinite number of 1s. The fractional part of the 
product is the binary equivalent of an infinite decimal fraction 0.999999 ..., which is equal 
to 1. But the CPU can store only a finite number of 1s, and it discards some of them when 
converting the result to a decimal number. 


RANDOM FACT 4.1 


The Pentium Floating-Point Bug 


In 1994, Intel Corporation released what was then its most powerful processor, the first of 
the Pentium series. Unlike previous generations of Intel’s processors, the Pentium had a very 
fast floating-point unit. Intel’s goal was to compete aggressively with the makers of higher- 
end processors for engineering workstations. The Pentium was an immediate success. 

In the summer of 1994, Dr. Thomas Nicely of Lynchburg College in Virginia ran an 
extensive set of computations to analyze the sums of reciprocals of certain sequences of 
prime numbers. The results were not always what his theory predicted, even after he took 
into account the inevitable roundoff errors. Then Dr. Nicely noted that the same program 
did produce the correct results when run on the slower 486 processor, which preceded the 
Pentium in Intel’s lineup. This should not have happened. The optimal roundoff behavior of 
floating-point calculations had been standardized by the Institute of Electrical and Electron- 
ics Engineers (IEEE), and Intel claimed to adhere to the IEEE standard in both the 486 and 
the Pentium processors. Upon further checking, Dr. Nicely discovered that indeed there was 
a very small set of numbers for which the product of two numbers was computed differently 
on the two processors. For example, 


4,195,835 = ((4,195,835 / 3,145,727) x 3,145,727) 


is mathematically equal to 0, and it did compute as 0 on a 486 processor. On a Pentium pro- 
cessor, however, the result was 256. 

As it turned out, Intel had independently discovered the bug in its testing and had started 
to produce chips that fixed it. (Subsequent versions of the Pentium, such as the Pentium II 
and IV, are free of the problem.) The bug was caused by an error in a table that was used to 
speed up the floating-point multiplication algorithm of the processor. Intel determined that 
the problem was exceedingly rare. They claimed that under normal use a typical consumer 
would only notice the problem once every 27,000 years. Unfortunately for Intel, Dr. Nicely 
had not been a normal user. 
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Now Intel had a real problem on its hands. It figured that replacing all the Pentium pro- 
cessors that it had already sold would cost it a great deal of money. Intel already had more 
orders for the chip than it could produce, and it would be particularly galling to have to give 
out the scarce chips as free replacements instead of selling them. Intel’s management decided 
to punt on the issue and initially offered to replace the processors only for those customers 
who could prove that their work required absolute precision in mathematical calculations. 
Naturally, that did not go over well with the hundreds of thousands of customers who had 
paid retail prices of $700 and more for a Pentium chip and did not want to live with the nag- 
ging feeling that perhaps, one day, their income tax program would produce a faulty return. 

Ultimately, Intel had to cave in to public demand and replaced all defective chips, at a cost 
of about 475 million dollars. 

What do you think? Intel claims that the probability of the bug occurring in any calcula- 
tion is extremely small—smaller than many chances you take every day, such as driving to 
work in an automobile. Indeed, many users had used their Pentium computers for many 
months without reporting any ill effects, and the computations that Professor Nicely was 
doing are hardly examples of typical user needs. As a result of its public relations blunder, 
Intel ended up paying a large amount of money. Undoubtedly, some of that money was 
added to chip prices and thus actually paid by Intel’s customers. Also, a large number of pro- 
cessors, whose manufacture consumed energy and caused some environmental impact, were 
destroyed without benefiting anyone. Could Intel have been justified in wanting to replace 
only the processors of those users who could reasonably be expected to suffer an impact 
from the problem? 

Suppose that, instead of stonewalling, Intel had offered you the choice of a free replace- 
ment processor or a $200 rebate. What would you have done? Would you have replaced 
your faulty chip, or would you have taken your chances and pocketed the money? 


In many programs, you need to use numerical constants —values that do not change 
and that have a special significance for a computation. 

A typical example for the use of constants is a computation that involves coin 
values, such as the following: 


payment = dollars + quarters * 0.25 + dimes * 0.1 
+ nickels * 0.05 + pennies * 0.01; 


Most of the code is self-documenting. However, the four numeric quantities, 0.25, 
0.1, 0.05, and 0.01 are included in the arithmetic expression without any explana- 
tion. Of course, in this case, you know that the value of a nickel is five cents, which 
explains the 0.05, and so on. However, the next person who needs to maintain this 
code may live in another country and may not know that a nickel is worth five 
cents. 

Thus, it is a good idea to use symbolic names for all values, even those that 
appear obvious. Here is a clearer version of the computation of the total: 
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double quarterValue = 0.25; 

double dimeValue = 0.1; 

double nickelValue = 0.05; 

double pennyValue = 0.01; 

payment = dollars + quarters * quarterValue + dimes * dimeValue 
+ nickels * nickelValue + pennies * pennyValue; 


There is another improvement we can make. There is a difference 
between the nickels and nickelValue variables. The nickels variable 
can truly vary over the life of the program, as we calculate different 
payments. But nickelValue is always 0.05. 

In Java, constants are identified with the keyword final. A variable 
tagged as final can never change after it has been set. If you try to change the value 
of a final variable, the compiler will report an error and your program will not 
compile. 


Many programmers use all-uppercase names for constants (final 
variables), such as NICKEL_VALUE. That way, it is easy to distinguish 
between variables (with mostly lowercase letters) and constants. 
ne We will follow this convention in this book. However, this rule is a 

matter of good style, not a requirement of the Java language. The compiler will 
not complain if you give a final variable a name with lowercase letters. 
Here is an improved version of the code that computes the value of a payment. 


final double QUARTER_VALUE = 0.25; 

final double DIME_VALUE = 0.1; 

final double NICKEL VALUE = 0.05; 

final double PENNY_VALUE = 0.01; 

payment = dollars + quarters * QUARTER_VALUE + dimes * DIME_VALUE 
+ nickels * NICKEL_VALUE + pennies * PENNY_VALUE; 


Frequently, constant values are needed in several methods. Then you should declare 
them together with the instance fields of a class and tag them as static and final. 
As before, final indicates that the value is a constant. The static keyword means 
that the constant belongs to the class—this is explained in greater detail in 


Chapter 8.) 
public class CashRegister 


// Methods 


// Constants 

public static final double QUARTER_VALUE = 0.25; 
public static final double DIME_VALUE = 0.1; 
public static final double NICKEL_VALUE = 0.05; 
public static final double PENNY_VALUE = 0.01; 
// Instance fields 

private double purchase; 

private double payment; 
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We declared the constants as public. There is no danger in doing this because con- 
stants cannot be modified. Methods of other classes can access a public constant b: 
first specifying the name of the class in which it is defined, then a period, then the 
name of the constant, such as CashRegister.NICKEL_VALUE. 

The Math class from the standard library defines a couple of useful constants: 


public class Math 
if 


public static final double E = 2.7182818284590452354; 
public static final double PI = 3.14159265358979323846; 
- 


You can refer to these constants as Math. PI and Math.E in any of your methods. For 
example, 


double circumference = Math.PI * diameter; 


The sample program at the end of this section puts constants to work. The program 
shows a refinement of the CashRegister class of How To 3.1. The public interface of 
that class has been modified in order to solve a common business problem. 

Busy cashiers sometimes make mistakes totaling up coin values. Our Cash- 
Register class features a method whose inputs are the coin counts. For example, the 
call 


register.enterPayment(1, 2, 1, 1, 4); 


enters a payment consisting of one dollar, two quarters, one dime, one nickel, and 
four pennies. The enterPayment method figures out the total value of the payment, 
$1.69. As you can see from the code listing, the method uses named constants for 
the coin values. 


SYNTAX 4.2 Constant Definition 


In a method: 
final typeName variableName = expression; 


In a class: 
accessSpecifier static final typeName variableName = expression; 


Example: 

final double NICKEL_VALUE = 0.05; 

public static final double LITERS _PER_GALLON = 3.785; 
Purpose: 


To define a constant in a method or a class 


4.2 


Constants 


ch04/cashregister/CashRegister.java 


1 j* * 


Woon amu WN 


A cash register totals up sales and computes change due. 


public class CashRegister 


ale ale 
won 


Constructs a cash register with no money in it. 


ad 
public CashRegister() 
{ 
purchase = (3 
payment = 0; 


Records the purchase price of an item. 

@param amount the price of the purchased item 
* / 
public void recordPurchase(double amount) 


{ 
} 
/ vet 


Enters the payment received from the customer. 
@param dollars the number of dollars in the payment 
@param quarters the number of quarters in the payment 
@param dimes the number of dimes in the payment 
@param nickels the number of nickels in the payment 
. @param pennies the number of pennies in the payment 
a 
public void enterPayment(int dollars, int quarters, 
int dimes, int nickels, int pennies) 


purchase = purchase + amount; 


{ 
payment = dollars + quarters * QUARTER_VALUE + dimes * 
+ nickels * NICKEL VALUE + pennies * PENNY_VALUE; 
} 
/ kk 


Computes the change due and resets the machine for the next customer. 


@return the change due to the customer 


* / 
public double giveChange() 


‘ 
double change = payment - purchase; 
purchase = (; 
payment = @; 
return change; 
} 


public static final double QUARTER_VALUE = ©.2°%; 
public static final double DIME_VALUE = 0.1; 
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53 public static final double NICKEL_VALUE = 0.05; 
54 public static final double PENNY_VALUE = 0.01; 
55 

56 private double purchase; 

57 private double payment; 

58 3 


ch04/cashregister/CashRegisterTester.java 


l f* % 
Z This class tests the CashRegister class. 
3 * / 
4 public class CashRegisterTester 
> { 
6 public static void main(String[] args) 
ri { 
8 CashRegister register = new CashRegister(); 
9 
10 register.recordPurchase(0. 75); 
11 register. recordPurchase(1.50); 
12 register.enterPayment(2, 0, 5, 0, 0); 
13 System.out.print("Change: "); 
14 System.out.printInCregister.giveChange() ) ; 
5 System.out.printinC"Expected: 0.25"); 
16 
17 register.recordPurchase(2.25); 
18 register.recordPurchase( 19.25); 
19 register.enterPayment(23, 2, 0, 0, 0); 
20 System.out.print("Change: "); 
21 System.out.printIn(register.giveChange()); 
22 System.out.printInC"Expected: 2.0"); 
23 } 
24 } 
Output 
Change: 0.25 
Expected: 0.25 
Change: 2.0 


Expected: 2.0 


SELF CHECK 


4. What is the difference between the following two statements? 
final double CM _PER_INCH = 2.54; 
and 
public static final double CM_PER_INCH = 2.54; 

5. What is wrong with the following statement? 


double circumference = 3.14 * diameter; 
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QUALITY TIP 4.1 
Do Not Use Magic Numbers 


A magic number is a numeric constant that appears in your code without explanation. For 
iaiisagian consider the following scary example that actually occurs in the Java library source: 


h = 31 * h + ch; 


Why 31? The number of days in January? One less than the number of bits in an integer? 
Actually, this code computes a “hash code” from a string—a number that is derived from the 
characters in such a way that different strings are likely to yield different hash codes. The 
value 31 turns out to scramble the character values nicely. 

A better solution is to use a named constant: 


final int HASH eae heeh = 31; 
h = HASH MULTIPLIER * h + ch; 


You should never use magic numbers in your code. Any number that is not completely self- 
explanatory should be declared as a named constant. Even the most reasonable cosmic con- 
stant is going to change one day. You think there are 365 days in a year? Your customers on 
Mars are going to be pretty unhappy about your silly prejudice. Make a constant 


final int DAYS _PER_YEAR = 365; 
By the way, the device 
final int THREE _HUNDRED_AND_SIXTY_FIVE = 365; 


is counterproductive and frowned upon. 


QUALITY TIP 4.2 
Choose Descriptive Variable Names 


In algebra, variable names are usually just one letter long, such as p or A, maybe with a sub- 
script such as p}. You might be tempted to save yourself a lot of typing by using short vari- 
able names in your Java programs: 


payment = d+ q * QV + di * DIV +n * NV +p * PV; 
Compare this with the following statement: 


payment = dollars + quarters * QUARTER_VALUE + dimes * DIME_VALUE 
+ nickels * NICKEL_VALUE + pennies * PENNY_VALUE; 


The advantage is obvious. Reading dollars is a lot less trouble than reading d and then figur- 
ing out that it must mean “dollars”. 

In practical programming, descriptive variable names are particularly important when 
programs are written by more than one person. It may be obvious to you that d stands for 
dollars, but is it obvious to the person who needs to update your code years later, long after 
you were promoted (or laid off)? For that matter, will you remember yourself what d means 
when you look at the code six months from now? 
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The = operator is called the assignment operator. On the left, you need a variable 
name. The right-hand side can be a single value or an expression. The assignment 
operator sets the variable to the given value. So far, that’s straightforward. But now 
let’s look at a more interesting use of the assignment operator. Consider the 
statement 


items = items + 1; 


It means, “Compute the value of the expression items + 1, and place the result 
again into the variable items.” (See Figure 1.) The net effect of executing this state- 
ment is to increment items by 1. For example, if items was 3 before execution of the 
statement, it is set to 4 afterwards. (This statement would be useful if the cash regis- 
ter kept track of the number of purchased items.) 

The = sign does not mean that the left-hand side is equal to the right-hand side. 
Instead, it is an instruction to copy the right-hand-side value into the left-hand-side 
variable. You should not confuse this assignment operation with the = relation used 
in algebra to denote equality. The assignment operator is an instruction to do some- 
thing, namely place a value into a variable. The mathematical equality states the fact 
that two values are equal. Of course, in mathematics it would make no sense to 
write that z=72+ 1; no integer can equal itself plus 1. 

The concepts of assignment and equality have no relationship 
with each other, and it is a bit unfortunate that the Java language (fol- 
lowing C and C++) uses = to denote assignment. Other program- 
ming languages use a symbol such as <- or :=, which avoids the 
confusion. 

The increment operation is so common when writing programs 
that there is a special shorthand for it, namely 


jtems++; 


This statement also adds 1 to items. However, it is easier to type and 
read than the explicit assignment statement. As you might have guessed, there is 
also a decrement operator --. The statement 


jtems--; 


subtracts 1 from items. 


items + 1 


Figure 1 
Incrementing a Variable 
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SELF CHECK 


6. What is the meaning of the following statement? 
balance = balance + amount; 


7. What is the value of n after the following sequence of statements? 


PRODUCTIVITY HINT 4.1 
Avoid Unstable Layout 


Arrange program code and comments so that the program is easy to read. For example, do 
not cram all statements on a single line, and make sure that braces { } line up. 

However, be careful when you embark on beautification efforts. Some programmers like 
to line up the = signs in a series of assignments, like this: 


nickels = 0; 
dimes 
quarters = 0; 


II 
© 


This looks very neat, but the layout is not stable. Suppose you add a line like the one at the 
bottom of this: 


nickels O; 
dimes =.0; 
quarters = QO; 
halfDollars = 0; 


Oops, now the = signs no longer line up, and you have the extra work of lining them up 
again. 

Here is another example. Some programmers like to put a column of asterisks (*) in docu- 
mentation comments, like this: 


[ue 
* Computes the change due and resets the cash register for the 
* next customer. 
* @return the change due to the customer 


ale 
aw 


It looks pretty, but it is tedious to rearrange the asterisks when editing comments. 

You may not care about these issues. Perhaps you plan to beautify your program just 
before it is finished, when you are about to turn in your homework. That is not a particu- 
larly useful approach. In practice, programs are never finished. They are continuously 
improved and updated. It is better to develop the habit of laying out your programs well 
from the start and keeping them legible at all times. Therefore, it is a good idea to avoid lay- 
out schemes that are hard to maintain. 
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ADVANCED TOPIC 4.3 


Combining Assignment and Arithmetic 


In Java you can combine arithmetic and assignment. For example, the instruction 
balance += amount; 
is a shortcut for 
balance = balance + amount; 
Similarly, 
items *= 2; 
is another way of writing 
items = items * 2; 


Many programmers find this a convenient shortcut. If you like it, go ahead and use it in your 
own code. For simplicity, we won’t use it in this book. 


Arithmetic Operations and 


You already saw how to add, subtract, and multiply values. Division is indicated 
with a /, not a fraction bar. For example, 


a+b 
ys 


becomes 
(a + b) / 2 


Parentheses are used just as in algebra: to indicate in which order the subexpressions 
should be computed. For example, in the expression (a + b) / 2, the suma + b 1s 
computed first, and then the sum is divided by 2. In contrast, in the expression 


a+b /2 


only b is divided by 2, and then the sum of a and b / 2 is formed. Just as in regular 
algebraic notation, multiplication and division bind more strongly than addition 
and subtraction. For example, in the expression a + b / 2, the / is carried out first, 
even though the + operation occurs farther to the left. 

vee Division works as you would expect, as long as at least one of the 
numbers involved is a floating-point number. That ts, 
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all yield 1.75. However, if both numbers are integers, then the result of the division 
is always an integer, with the remainder discarded. That is, 


7/4 


evaluates to 1, because 7 divided by 4 is 1 with a remainder of 3 (which is discarded). 
This can be a source of subtle programming errors—see Common Error 4.1. 

If you are interested only in the remainder of an integer division, 
use the % operator: 


7% 4 


is 3, the remainder of the integer division of 7 by 4. The % symbol has no analog in 
algebra. It was chosen because it looks similar to /, and the remainder operation is 
related to division. 

Here 1s a typical use for the integer / and % operations. Suppose you want to 
know how much change a cash register should give, using separate values for dollars 
and cents. You can compute the value as an integer, denominated in cents, and then 
compute the whole dollar amount and the remaining change: 


final int PENNIES PER_NICKEL = 5; 
final int PENNIES PER_DIME = 10; 
final int PENNIES PER_QUARTER = 25; 
final int PENNIES PER_DOLLAR = 100; 


// Compute total value in pennies 
Int total = dollars * PENNIES PER_DOLLAR + quarters * PENNIES PER QUARTER 
+ nickels * PENNIES PER_NICKEL + dimes * PENNIES PER _DIME + pennies; 


// Use integer division to convert to dollars, cents 
int dollars = total / PENNIES PER DOLLAR; 
int cents = total % PENNIES PER DOLLAR; 


For example, if total is 243, then dollars is set to 2 and cents to 43. 
: : To compute x”, you write Math.pow(x, n). However, to compute 
x? it is significantly more efficient simply to compute x * x. 

To take the square root of a number, you use the Math.sqrt 
method. For example, Vx is written as Math. sqrt (x). 

In algebra, you use fractions, superscripts for exponents, and radi- 
cal signs for roots to arrange expressions in a compact two-dimensional form. In 
Java, you have to write all expressions in a linear arrangement. For example, the 
subexpression 


—~b+~b? —4ac 


2a 
of the quadratic formula becomes 


(-b + Math.sqrt(b * b - 4 * a * c)) / (2 * a) 
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Figure 2 shows how to analyze such an expression. With complicated expressions 
like these, it is not always easy to keep the parentheses ( ) matched—see Common 
Liror 4.2. 

Table 2 shows additional methods of the Math class. Inputs and outputs are 
floating-point numbers. 


Table 2 Mathematical Methods 


Function Returns 
Math. sqrt (x) Square root of x (20) 


Math.pow(x, y) x” (x >0, orx =O and y >0, or x <0 and y 1s an integer) 


Math.sin(x) Sine of x (x in radians) 
Math.cos(x) Cosine of x 
Math. tan(x) | Tangent of x 
Math. asin(x) Arc sine (sin !x @ | 1/2, 7/2); x ¢ [-1, 1)) 
Math. acos(x) : Arc cosine (cos x e [0, a], x € [-1, 1]) 
Math.atan(x) Arc tangent (tan /x € [-2/2, n/2]) 
Math.atan2(y, x) Arc tangent (tan !y/x € [-z, m]), x may be 0 
Math. toRadians (x) Convert x degrees to radians (i.e., returns x - 2/180) | ; 
Math. toDegrees (x) Convert x radians to degrees (1.e., returns x 186/ Tt) 
Math. exp (x) e~ - 
Math. log(x) Natural log (In(x), x > 0) 
Math. round(x) Closest integer to x (as a long) 
Math.ceil (x) Smallest integer >x (as a double) 
Math. floor (x) Largest integer <x (as a double) 
Math.abs (x) Absolute value |x| _ 
Math.max(x, y) : The larger of x and y | 


Math.min(x, y) The smaller of x and y 
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(-b + Math.sart(b * b-4*a x cC)) j (2 * a) 


— ane ee 
b? 4ac 2a 
———, 

b*—4ac 


-~b + .{b*-4ac 


TF 


-b + .}b* -4ac 


2a 


Figure 2 Analyzing an Expression 


SELF CHECK 


8. What is the value of 1729 / 100? Of 1729 % 100? 
9. Why doesn’t the following statement compute the average of s1, s2, and s3? 
double average = sl + s2 + s3 / 3; // Error 


10. What is the value of Math.sqrt(Math.pow(x, 2) + Math.pow(y, 2)) in mathe- 
matical notation? 


COMMON ERROR 4.1 


Integer Division 


It is unfortunate that Java uses the same symbol, namely /, for both integer and floating- 
point division. These are really quite different operations. It is a common error to use integer 
division by accident. Consider this program segment that computes the average of three 
integers. 


int sl = 5; // Score of test 1 

int s2 = 6; // Score of test 2 

int s3 = 3; // Score of test 3 

double average = (sl + s2 + s3) / 3; // Error 
System.out.print("Your average score is "); 
System.out.printIn(average) ; 


What could be wrong with that? Of course, the average of s1, s2, and s3 is 


3 
Here, however, the / does not mean division in the mathematical sense. It denotes integer 


division, because the values s1 + s2 + s3 and 3 are both integers. For example, if the scores 
add up to 14, the average is computed to be 4, the result of the integer division of 14 by 3. 
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That integer 4 is then moved into the floating-point variable average. The remedy is to make 
either the numerator or denominator into a floating-point number: 


double total = sl + s2 + s3; 
double average = total / 3; 


or 


double average = (sl + s2 + s3) / 3.0; 


COMMON ERROR 4.2 


Unbalanced Parentheses 


Consider the expression 
1.5 * ((-(b - Math.sqrt(b * b - 4 * a * c)) / C2 * ad) 


What is wrong with it? Count the parentheses. There are five opening parentheses ( and four 
closing parentheses ). The parentheses are unbalanced. This kind of typing error 1s very 
common with complicated expressions. Now consider this expression. 


1.5 * (Math.sqrt(b * b - 4 * a * c))) - Cb / (2 * a)) 


This expression has five opening parentheses ( and five closing parentheses ), but it is still 
not correct. In the middle of the expression, 


1.5 * (Math.sqrt(b * b - 4 * a * c))) - COb / (2 * a)) 


there are only two opening parentheses ( but three closing parentheses ), which is an error. 
In the middle of an expression, the count of opening parentheses must be greater than or 
equal to the count of closing parentheses, and at the end of the expression the two counts 
must be the same. 

Here is a simple trick to make the counting easier without using pencil and paper. It is dit- 
ficult for the brain to keep two counts simultaneously, so keep only one count when scan- 
ning the expression. Start with 1 at the first opening parenthesis; add 1 whenever you see an 
opening parenthesis; subtract 1 whenever you see a closing parenthesis. Say the numbers 
aloud as you scan the expression. If the count ever drops below zero, or if it is not zero at the 
end, the parentheses are unbalanced. For example, when scanning the previous expression, 
you would mutter 


1.5 * (Math.saqrt(b * b - 4 * a * c) 
1 2 1 


and you would find the error. 


yy = OR fie *a)) 
0 -1 


QUALITY TIP 4.3 


White Space 


The compiler does not care whether you write your entire program onto a single line or 
place every symbol onto a separate line. The human reader, though, cares very much. You 
should use blank lines to group your code visually into sections. For example, you can signal 
to the reader that an output prompt and the corresponding input statement belong together 
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by inserting a blank line before and after the group. You will find many examples in the 
source code listings in this book. 
White space inside expressions is also important. It is easier to read 


x1 = (-b + Math.sqrt(b * b - 4 * a * c)) / (2 * a); 
than 

x1=(-b+Math. sqrt (b*b-4*a*c))/(2*a); 
Simply put spaces around all operators + - * / % =. However, don’t put a space after a 
unary minus: a - used to negate a single quantity, as in -b. That way, it can be easily distin- 
guished from a binary minus, as ina - b. Don’t put spaces between a method name and the 


parentheses, but do put a space after every Java keyword. That makes it easy to see that the 
sqrt in Math. sqrt(x) is a method name, whereas the if inif (x > 0)... isa keyword. 


QUALITY TIP 4.4 
Factor Out Common Code 


Suppose you want to find both solutions of the quadratic equation ax” + bx + c= 0. The qua- 
dratic formula tells us that the solutions are 


_ -b+ Vb? - 4ac 
a 4 
In Java, there is no analog to the + operation, which indicates how to obtain two solutions 


simultaneously. Both solutions must be computed separately: 


x1 (-b + Math.sqrt(b * b - 4 * a * c)) / (2 * a): 
x2 = (-b - Math.sqrt(b * b- 4* a*c)) / (2 * a); 


This approach has two problems. First, the computation of Math.sqrt(b * b - 4 * a * c) 
EE 4 E 

is carried out twice, which wastes time. Second, whenever the same code is replicated, the 
possibility of a typing error increases. The remedy is to factor out the common code: 


double root = Math.sqrt(b * b - 4 * a * c); 
x1 = (-b + root) / (2 * a); 
x2 = (-b - root) / (2 * a); 


You could go even further and factor out the computation of 2 * a, but the gain from factor- 
ing out very simple computations is too small to warrant the effort. 


In the preceding section, you encountered the Math class, which contains a collec- 

tion of helpful methods for carrying out mathematical computations. These meth- 

ods have a special form: they are static methods that do not operate on an object. 
That is, you don’t call 


double x = 4; 
double root = x.sqrtQ); // Error 
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because, in Java, numbers are not objects, so you can never invoke a method on a 
number. Instead, you pass a number as an explicit parameter to a method, enclosing 
the number in parentheses after the method name. For example, the number value x 
can be a parameter of the Math. sqrt method: Math. sqrt (x). 

This call makes it appear as if the sqrt method is applied to an 
object called Math, because Math precedes sqrt just as harrysChecking 
precedes getBalance in a method call harrysChecking.getBalance(). 
However, Math is a class, not an object. A method such as Math. round that does not 
operate on any object is called a static method. (The term “static” is a historical 
holdover from the C and C++ programming languages. It has nothing to do with 
the usual meaning of the word.) Static methods do not operate on objects, but they 
are still defined inside classes. You must specify the class to which the sqrt method 
belongs—hence the call is Math. sqrt (x). 

How can you tell whether Math is a class or an object? All classes in the Java 
library start with an uppercase letter (such as System). Objects and methods start with 
a lowercase letter (such as out and print1n). (You can tell objects and methods apart 
because method calls are followed by parentheses.) Therefore, System.out.printIn© 
denotes a call of the printin method on the out object inside the System class. On 
the other hand, Math.sqrt(x) denotes a call to the sqrt method inside the Math class. 
This use of upper- and lowercase letters is merely a convention, not a rule of the 
Java language. It is, however, a convention that the authors of the Java class libraries 
follow consistently. You should do the same in your programs. If you give names to 
objects or methods that start with uppercase letters, you will likely contuse your 
fellow programmers. Therefore, we strongly recommend that you follow the stan- 
dard naming convention. 


SYNTAX 4.3 Static Method Call 


ClassName .methodName (parameters) 


Example: 
Math.sqrt(4) 


Purpose: 


To invoke a static method (a method that does not operate on an object) and supply its 
parameters 


SELF CHECK 


11. Why can’t you call x.pow(y) to compute x”? 
12. Is the call System.out.print1In(4) a static method call? 


4.5 «= Calling Static Methods 155 


COMMON ERROR 4.3 
Roundoff Errors 


Roundoff errors are a fact of life when calculating with floating-point numbers. You proba- 
bly have encountered this phenomenon yourself with manual calculations. If you calculate 
1/3 to two decimal places, you get 0.33. Multiplying again by 3, you obtain 0.99, not 1.00. 

In the processor hardware, numbers are represented in the binary number system, not in 
decimal. You still get roundoff errors when binary digits are lost. They just may crop up at 
different places than you might expect. Here is an example: 


double f = 4.35; 
int n = Cint) (100 * Ff); 
System.out.printIn(n); // Prints 434! 


Of course, one hundred times 4.35 is 435, but the program prints 434. 

Computers represent numbers in the binary system (see Advanced Topic 4.2). In the 
binary system, there is no exact representation for 4.35, just as there 1s no exact representa- 
tion for 1/3 in the decimal system. The representation used by the computer is just a little 
less than 4.35, so 100 times that value is just a little less than 435. When a floating-point value 
is converted to an integer, the entire fractional part is discarded, even if it is almost 1. As a 
result, the integer 434 is stored in n. Remedy: Use Math. round to convert floating-point num- 
bers to integers. The round method returns the closest integer. 


int n = (int) Math.round(100 * f); // OK, nis 435 


How To 4.1 


Carrying Out Computations 


Many programming problems require that you use mathematical formulas to compute val- 
ues. It is not always obvious how to turn a problem statement into a sequence of mathemati- 
cal formulas and, ultimately, statements in the Java programming language. 


Step 1. Understand the problem: What are the inputs? What are the desired outputs? 


For example, suppose you are asked to simulate a postage stamp vending machine. A cus- 
tomer inserts money into the vending machine. Then the customer pushes a “First class 
stamps” button. The vending machine gives out as many first-class stamps as the customer 
paid for. (A first-class stamp cost 39 cents at the time this book was written.) Finally, the cus- 
tomer pushes a “Penny stamps” button. The machine gives the change in penny (1-cent) 
stamps. 

In this problem, there is one input: 


e The amount of money the customer inserts 

There are two desired outputs: 

e The number of first-class stamps the machine returns 
e The number of penny stamps the machine returns 


Step 2. Work out examples by hand. 


This is a very important step. If you can’t compute a couple of solutions by hand, it’s 
unlikely that you’ll be able to write a program that automates the computation. 
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Let’s assume that a first-class stamp costs 39 cents and the customer inserts $1.00. That’s 
enough for two stamps (78 cents) but not enough for three stamps ($1.17). Therefore, the 
machine returns two first-class stamps and 22 penny stamps. 


Step 3. Find mathematical equations that compute the answers. 


Given an amount of money and the price of a first-class stamp, how can you compute how 
many first-class stamps can be purchased with the money? Clearly, the answer is related to 
the quotient 


amount of money 
price of first-class stamp 
For example, suppose the customer paid $1.00. Use a pocket calculator to compute the quo- 
tient: $1.00/$0.39 = 2.5641. 
How do you get “2 stamps” out of 2.5641? It’s the integer part. By discarding the frac- 


tional part, you get the number of whole stamps the customer has purchased. 
In mathematical notation, 


money | 


number of first-class stamps = | ———————____ 
price of first-class stamp 


where Lx|denotes the largest integer <x. That function is sometimes called the “floor 
function”. 

You now know how to compute the number of stamps that are given out when the cus- 
tomer pushes the “First-class stamps” button. When the customer gets the stamps, the 
amount of money is reduced by the value of the stamps purchased. For example, if the cus- 
tomer gets two stamps, the remaining money is $0.22—the difference between $1.00 and 
2 - $0.39. Here is the general formula: 


remaining money = money — number of first-class stamps - price of first-class stamp 


How many penny stamps does the remaining money buy? That’s easy. If $0.22 is left, the 
customer gets 22 stamps. In general, the number of penny stamps is 


number of penny stamps = 100 - remaining money 
Step 4 Turn the mathematical equations into Java statements. 


In Java, you can compute the integer part of a nonnegative floating-point value by applying 
an (int) cast. Therefore, you can compute the number of first-class stamps with the follow- 
ing statement: 


firstClassStamps = Cint) (money / FIRST_CLASS STAMP_PRICE); 
money = money - firstClassStamps * FIRST_CLASS STAMP_PRICE; 


Finally, the number of penny stamps is 
pennyStamps = 100 * money; 


That’s not quite right, though. The value of pennyStamps should be an integer, but the right- 
hand side is a floating-point number. Therefore, the correct statement is 


pennyStamps = (int) Math.round(100 * money); 
Step 5 Build a class that carries out your computations. 


How To 3.1 explains how to develop a class by finding methods and instance variables. In 
our case, we can find three methods: 
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® void insert(double amount) 

® int giveFirstClassStamps() 

® int givePennyStamps() 

The state of a vending machine can be described by the amount of money that the customer 


has available for purchases. Therefore, we supply one instance variable, money. 
Here is the implementation: 


public class StampMachine 


{ 

public StampMachine() 

{ 
money = QO; 

} 

public void insert(double amount) 

{ 
money = money + amount; 

} 

public int giveFirstClassStamps() 

{ 
int firstClassStamps = (int) (money / FIRST_CLASS STAMP_PRICE) ; 
money = money - firstClassStamps * FIRST_CLASS_ STAMP_PRICE; 
return firstClassStamps; 

} 

public int givePennyStamps() 

{ 
int pennyStamps = Cint) Math.round(100 * money); 
money = QO; 
return pennyStamps; 

} 

public static final double FIRST_CLASS STAMP_PRICE = 0.39; 

private double money; 

} 


Step 6 Test your class. 


Run a test program (or use an integrated environment such as Blue]) to verify that the values 
that your class computes are the same values that you computed by hand. In our example, 
try the statements 


StampMachine machine = new StampMachine() ; 
machine.insert(1); 

System.out.printC"First class stamps: "); 
System.out.printIn(machine.giveFirstClassStamps()); 
System.out.printInC"Expected: 2"); 
System.out.print("Penny stamps: "); 
System.out.printIln(machine.givePennyStamps()); 
System.out.printInC"Expected: 22); 


Check that the result is 


First class stamps: 2 
Expected: 2 

Penny stamps: 22 
Expected: 22 
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Next to numbers, strings are the most important data type that most programs use. 
A string is a sequence of characters, such as "Hello, World!". In Java, strings are 
enclosed in quotation marks, which are not themselves part of the string. Note that, 
unlike numbers, strings are objects. (You can tell that String is a class name because 
it starts with an uppercase letter. The primitive types int and double start with low- 
ercase letters.) 


The number of characters in a string is called the length of the 
string. For example, the length of "Hello, World!" is 13. You can 
compute the length of a string with the length method. 


int n = message. lengthQ); 


A string of length zero, containing no characters, is called the empty string and is 
written as '"". 
Use the + operator to put strings together to form a longer string. 


String name = "Dave"; 
String message = "Hello, " + name; 


The + operator concatenates two strings, provided one of the expres- 
sions, either to the left or the right of a + operator, is a string. The 
other one is automatically forced to become a string as well, and both 
strings are concatenated. 

For example, consider this code: 

String a = "Agent"; 

int n=/7; 

String bond = a +n; 
Because a is a string, n is converted from the integer 7 to the string 
"7". Then the two strings "Agent" and "7" are concatenated to form 
the string "Agent7". 

This concatenation is very useful to reduce the number of System. 
out.print instructions. For example, you can combine 


System.out.printC"The total is "); 
System.out.printIn(total) ; 


to the single call 
System.out.printInC"The total is " + total); 


The concatenation "The total is " + total computes a single string that consists of 
the string "The total is ", followed by the string equivalent of the number total. 

Sometimes you have a string that contains a number, usually from user input. For 
example, suppose that the string variable input has the value "19". To get the integer 
value 19, you use the static parseInt method of the Integer class. 


int count = Integer.parseInt(Cinput) ; 
// count is the integer 19 
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Figure 3 String Positions 


To convert a string containing floating-point digits to its floating- 
point value, use the static parseDouble method of the Double class. For 
example, suppose input is the string "3.95". 


double price = Double.parseDoubleCinput) ; 
// price is the floating-point number 3.95 


However, if the string contains spaces or other characters that cannot 
occur inside numbers, an error occurs. For now, we will always 
assume that user input does not contain invalid characters. 

The substring method computes substrings of a string. The call 


s.substring(start, pastEnd) 


returns a string that is made up of the characters in the string s, start- 
ing at position start, and containing all characters up to, but not including, the 
position pastEnd. Here is an example: 


String greeting = "Hello, World!"; 
String sub = greeting.substring(O, 5); // sub is "Hello" 


The substring operation makes a string that consists of five charac- 
ters taken from the string greeting. A curious aspect of the substring 
operation is the numbering of the starting and ending positions. The 
first string position is labeled 0, the second one 1, and so on. For 
example, Figure 3 shows the position numbers in the greeting string. 

The position number of the last character (12 for the string "Hello, World!") is 
always 1 less than the length of the string. 

Let us figure out how to extract the substring "World". Count characters starting 
at 0, not 1. You find that w, the eighth character, has position number 7. The first 
character that you don’t want, !, is the character at position 12 (see Figure 4). 
Therefore, the appropriate substring command 1s 


String sub2 = greeting.substring(7, 12); 


It is curious that you must specify the position of the first character that you do 
want and then the first character that you don’t want. There is one advantage to this 


O12 3 4 5 6#7 8 9 10 11412 


Figure 4 Extracting a Substring 
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setup. You can easily compute the length of the substring: It is pastEnd - start. For 
example, the string "World" has length 12-7 =5. 

If you omit the second parameter of the substring method, then all characters 
from the starting position to the end of the string are copied. For example, 


String tail = greeting.substring(7); // Copies all characters from position 7 on 


sets tail to the string "World!". 

If you supply an illegal string position (a negative number, or a value that is 
larger than the length of the string), then your program terminates with an error 
message. 

In this section, we have made the assumption that each character in a string occu- 
pies a single position. Unfortunately, that assumption is not quite correct. If you 
process strings that contain characters from international alphabets or special sym- 
bols, some characters may occupy two positions—see Advanced Topic 4.5. 


SELF CHECK 


13. Assuming the String variable s holds the value "Agent", what is the effect of the 
assignment s = s + s.length()? 


14. Assuming the String variable river holds the value "Mississippi", what is the 
value of river.substring(1, 2)? Of river.substring(2, river.length(Q) - 3)? 


PRODUCTIVITY HINT 4.2 


Reading Exception Reports 


You will often have programs that terminate and display an error message, such as 


Exception in thread "main" java. lang.StringIndexOutOfBoundsException: 
String index out of range: -4 
at java. lang.String.substring(String. java: 1444) 
at Homework1.main(Homework1.java:16) 


An amazing number of students simply give up at that point, saying “it didn’t work”, or 
“my program died”, without ever reading the error message. Admittedly, the format of the 
exception report is not very friendly. But it is actually easy to decipher it. 
When you have a close look at the error message, you will notice two pieces of useful 
information: 


1. The name of the exception, such as StringIndexOutOfBoundsException 


2. The line number of the code that contained the statement that caused the exception, 
such as Homework1. java: 16 


The name of the exception is always in the first line of the report, and it ends in Exception. If 
you get a StringIndexOutOfBoundsException, then there was a problem with accessing an 
invalid position in a string. That is useful information. 

The line number of the offending code is a little harder to determine. The exception 
report contains the entire stack trace—that is, the names of all methods that were pending 
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when the exception hit. The first line of the stack trace is the method that actually generated 
the exception. The last line of the stack trace is a line in main. Often, the exception was 
thrown by a method that is in the standard library. Look for the first line in your code that 
appears in the exception report. For example, skip the line that refers to 


java.lang.String. substring(String. java: 1444) 


The next line in our example mentions a line number in your code, Homework1. java. Once 
you have the line number in your code, open up the file, go to that line, and look at it! In the 
great majority of cases, knowing the name of the exception and the line that caused it make it 
completely obvious what went wrong, and you can easily fix your error. 


ADVANCED TOPIC 4.4 


Escape Sequences 


Suppose you want to display a string containing quotation marks, such as 
Hello, "World"! 

You can’t use 
System.out.printInC"Hello, "World"™!"); 


As soon as the compiler reads "Hello, ", it thinks the string is finished, and then it gets all 
confused about world followed by two quotation marks. A human would probably realize 
that the second and third quotation marks were supposed to be part of the string, but a 
compiler has a one-track mind. If a simple analysis of the input doesn’t make sense to it, 
it just refuses to go on, and reports an error. Well, how do you then display quotation marks 
on the screen? You precede the quotation marks inside the string with a backslash character. 
Inside a string, the sequence \" denotes a literal quote, not the end of a string. The correct 
display statement is, therefore 


System.out.printInC"Hello, \"World\"!"); 


The backslash character is used as an escape character; the character sequence \" is called an 
escape sequence. The backslash does not denote itself; instead, it is used to encode other 
characters that would otherwise be difficult to include in a string. 

Now, what do you do if you actually want to print a backslash (for example, to specify a 
Windows file name)? You must enter two \\ in a row, like this: 


System.out.printiIn("The secret message is in C:\\Temp\\Secret.txt") ; 
This statement prints 
The secret message is in C:\Temp\Secret.txt 


Another escape sequence occasionally used is \n, which denotes a newline or line feed char- 
acter. Printing a newline character causes the start of a new line on the display. For example, 
the statement 


System.out.printC’*\n**\n***\n") ; 


prints the characters 
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on three separate lines. Of course, you could have achieved the same effect with three sepa- 
rate calls to printIn. 

Finally, escape sequences are useful for including international characters in a string. For 
example, suppose you want to print “All the way to San José!”, with an accented letter (é). If 
you use a U.S. keyboard, you may not have a key to generate that letter. Java uses the Uni- 
code encoding scheme to denote international characters. For example, the é character has 
Unicode encoding 00E9. You can include that character inside a string by writing \u, fol- 
lowed by its Unicode encoding: 


System.out.printInCc"All the way to San Jos\u00E9!"); 


You can look up the codes for the U.S. English and Western European characters in Appen- 
dix B, and codes for thousands of characters in reference [1]. 


ADVANCED Topic 4.5 
Strings and the char Type 


Strings are sequences of Unicode characters (see Random Fact 4.2). Character constants 
look like string constants, except that character constants are delimited by single quotes: 'H' 
is a character, "H" is a string containing a single character. You can use escape sequences (see 
Advanced Topic 4.4) inside character constants. For example, '\n' is the newline character, 
and '\u00E9' is the character é. You can find the values of the character constants that are 
used in Western European languages in Appendix B. 

Characters have numeric values. For example, if you look at Appendix B, you can see that 
the character 'H' is actually encoded as the number 72. 

When Java was first designed, each Unicode character was encoded as a two-byte quan- 
tity. The char type was intended to hold the code of a Unicode character. However, as of 
2003, Unicode had grown so large that some characters needed to be encoded as pairs of char 
values. Thus, you can no longer think of a char value as a character. Technically speaking, a 
char value is a code unit in the UTF-16 encoding of Unicode. That encoding represents the 
most common characters as a single char value, and less common or supplementary charac- 
ters as a pair of char values. 

The charAt method of the String class returns a code unit from a string. As with the sub- 
string method, the positions in the string are counted starting at 0. For example, the 
statement 


String greeting = "Hello"; 
char ch = greeting.charAt(0) ; 


sets ch to the value 'H'. 

However, if you use char variables, your programs may fail with some strings that con- 
tain international or symbolic characters. For example, the single character Z (the mathemat- 
ical symbol for the set of integers) is encoded by the two code units '\uD835"' and '\uDD6B'. 

If you call charAt(0) on the string containing the single character Z (that is, the string 
"\uD835\uDD6B"), you only get the first half of a supplementary character. 

Therefore, you should only use char values if you are absolutely sure that you won’t need 
to encode supplementary characters. 
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RANDOM FACT 4.2 


International Alphabets 


The English alphabet is pretty simple: upper- and lowercase a to z. Other European lan- 
euages have accent marks and special characters. For example, German has three umlaut 
characters (a, 6, ti) and a double-s character (3). These are not optional frills; you couldn’t 
write a page of German text without using these characters. German computer keyboards 
have keys for these characters (see A German Keyboard). 

This poses a problem for computer users and designers. The American standard character 
encoding (called ASCII, for American Standard Code for Information Interchange) specifies 
128 codes: 52 upper- and lowercase characters, 10 digits, 32 typographical symbols, and 34 
control characters (such as space, newline, and 32 others for controlling printers and other 
devices). The umlaut and double-s are not among them. Some German data processing sys- 
tems replace seldom-used ASCII characters with German letters: [ \ ] { | } ~ are replaced 
with AO U a6 8. Most people can live without those ASCII characters, but programmers 
using Java definitely cannot. Other encoding schemes take advantage of the fact that one 
byte can encode 256 different characters, but only 128 are standardized by ASCII. Unfortu- 
nately, there are multiple incompatible standards for using the remaining 128 characters, 
resulting in a certain amount of aggravation among e-mail correspondents in different Euro- 
pean countries. 

Many countries don’t use the Roman script at all. Russian, Greek, Hebrew, Arabic, and 
Thai letters, to name just a few, have completely different shapes (see The Thai Alphabet). To 
complicate matters, scripts like Hebrew and Arabic are written from right to left instead of 
from left to right, and many of these scripts have characters that stack above or below other 
characters, as those marked with a dotted circle in The Thai Alphabet do in Thai. Each of 
these alphabets has between 30 and 100 letters, and the countries using them have established 
encoding standards for them. 

The situation is much more dramatic in languages that use Chinese script: the Chinese 
dialects, Japanese, and Korean. The Chinese script is not alphabetic but ideographic—a char- 
acter represents an idea or thing rather than a single sound. (See A Menu with Chinese Char- 
acters; can you identify the characters for soup, chicken, and wonton?) Most words are made 
up of one, two, or three of these ideographic characters. Tens of thousands of ideographs are 
in active use, and China, Tatwan, Hong Kong, Japan, and Korea developed incompatible 
encoding standards for them. 


A German Keyboard 
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The Thai Alphabet 


The inconsistencies among character encodings have been a major nuisance for interna- 
tional electronic communication and for software manufacturers vying for a global market. 
Between 1988 and 1991 a consortium of hardware and software manufacturers developed a 
uniform encoding scheme called Unicode that is expressly designed to encode text in all 
written languages of the world (see reference [1]). In the first version of Unicode, about 
39,000 characters were given codes, including 21,000 Chinese ideographs. A 2-byte code 
(which can encode over 65,000 characters) was chosen. It was thought to leave ample space 
for expansion for esoteric scripts, such as Egyptian hieroglyphs and the ancient script used 
on the island of Java. 

Java was one of the first programming languages to embrace Unicode. The primitive type 
char denotes a 2-byte Unicode character. (All Unicode characters can be stored in Java 
strings, but which ones can actually be displayed depends on your computer system.) 


CLASSIC SOUPS Sm. Lg. 

a Hk MR tS 57. House Chicken Soup (Chicken, Celery, 
Foto, TIMION, Carrol) serscacncmaccscumtawenes 1.50 245 
ye GR Oe (O58. CTC KEN) FCC SO ascadeccct cine teearenareersammeansdads 1.60. 3.20 
ae SB 5Y. Chicken Noodle SOU6: cccccccsserasrdaisscasarddoranaesscs 1389 2:20 
ff R Ff & 60. Cantonese Wonton Soup.......ccccscccccssssceeeeeeeeeees 1.50 2.75 
€ 3 FS B O61. Tomato Clear Eqag Drop SOUD scsinisssacetiicnrdecceses 1.65 2.95 
Ff & 8 62. Regular Wonton Soup ...........:ceccceeeecceseeeeeeeeenees 1.10 2.10 
SS FR we 05. Ch Plot S SOUP SOUp : secssswisetinidesddedscensesisiswerecaienes 1.10 2.10 
Se ft iB 64. aie (08 B) co) ogo 0]! |e enemy Ren me te ene teen eee LAU 2.10 
Ff 2s Bs 65. EG D160 WOO 10k essa ces casscnsnaiacncesscisavvancraes 1.10 2.10 
a2 8 R s& 66. TOT: VEGEtAGlS SGD os inacecacsindonteisccecccnsevreveneons NA 3.50 
Re EF KR 3B 67. Chicken Corn Cream Soup ...........cccsscccaeseeeeeeees NA 3.50 
Y AE Kise 68. Crab Meat Corn Cream Soup........cccccccceeeeeeeeees NA 3.50 
&  :& 69. Seafood SOup.........ccceccescccseceescceseecscccseceeeccasseens NA 3.50 


A Menu with Chinese Characters 
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Unfortunately, in 2003, the inevitable happened. Another large batch of Chinese ideo- 
graphs had to be added to Unicode, pushing it beyond the 16-bit limit. Now, some charac- 
ters need to be encoded with a pair of char values. 


The Java programs that you have made so far have constructed 
objects, called methods, printed results, and exited. They were not 
interactive and took no user input. In this section, you will learn one 
method for reading user input. 

Because output is sent to System. out, you might think that you use System. in for 
input. Unfortunately, it isn’t quite that simple. When Java was first designed, not 
much attention was given to reading keyboard input. It was assumed that all pro- 
grammers would produce graphical user interfaces with text fields and menus. Sys- 
tem.in was given a minimal set of features—it can only read one byte at a time. 
Finally, in Java version 5, a Scanner class was added that lets you read keyboard 
input in a convenient manner. 

To construct a Scanner object, simply pass the System.in object to the Scanner 
constructor: 


Scanner in = new Scanner(System. in) ; 


You can create a scanner out of any input stream (such as a file), but you will usu- 
ally want to use a scanner to read keyboard input from System. in. 

Once you have a scanner, you use the nextInt or nextDouble methods to read the 
next integer or floating-point number. 


System.out.printC"Enter quantity: "); 
int quantity = in.nextIntQ; 


System.out.printC"Enter price: "); 
double price = in.nextDouble() ; 


When the nextInt or nextDouble method is called, the program waits until the user 
types a number and hits the Enter key. You should always provide instructions for 
the user (such as "Enter quantity:") before calling a Scanner method. Such an 
instruction is called a prompt. 

The nextLine method returns the next line of input (until the user hits the Enter 
key) as a String object. The next method returns the next word, terminated by any 
white space, that is, a space, the end of a line, or a tab. 


System.out.printC"Enter city: "); 
String city = in.nextLineQ); 


System.out.print("Enter state code: "); 
String state = in.next(); 


Here, we use the nextLine method to read a city name that may consist of multiple 
words, such as San Francisco. We use the next method to read the state code (such 
as CA), which consists of a single word. 
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Here is an example of a class that takes user input. This class uses the CashRegis- 
ter class and simulates a transaction in which a user purchases an item, pays for it, 
and receives change. 

We call this class CashRegisterSimulator, not CashRegisterTester. We reserve the 
Tester suffix for classes whose sole purpose is to test other classes. 


ch04/cashregister/CashRegisterSimulator.java 


1 import java.util.Scanner: 


3 /* * 
4 This program simulates a transaction in which a user pays for an item 
5 and receives change. 
6 */ 
7 public class CashRegisterSimulator 
8 { 
9 public static void main(String[] args) 
10 if 
ll Scanner in = new Scanner(System.in); 
12 
13 CashRegister register = new CashRegister(); 
14 
15 System.out.print("Enter price: "); 
16 double price = in.nextDouble(); 
L7 register. recordPurchase(price); 
18 
19 System.out.print("Enter dollars: "): 
20 int dollars = in.nextInt(); 
21 System.out.print("Enter quarters: "); 
22 int quarters = in.nextInt(); 
rae System.out.print("Enter dimes: "); 
24 int dimes = in.nextInt(); 
25 System.out.print("Enter nickels: "): 
26 int nickels = in.nextInt(); 
27 System.out.print("Enter pennies: "); 
28 int pennies = in.nextInt(); 
29 register.enterPayment(dollars, quarters, dimes, nickels, pennies); 
30 
31 System.out.print("Your change: "); 
32 System.out.printIn(register.giveChange()); 
33 } 
34 } 
Output 


Enter price: 7.55 
Enter dollars: 10 
Enter quarters: 2 
Enter dimes: 1 

Enter nickels: 0 
Enter pennies: 0 
Your change: 3.05 
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SELF CHECK 


15. Why can’t input be read directly from System. in? 
16. Suppose in is a Scanner object that reads from System. in, and your pee calls 
String name = in.next(); 


What is the value of name if the user enters John Q. Public? 


ADVANCED TOPIC 4.6 


Formatting Numbers 


The default format for printing numbers is not always what you would like. For example, 
consider the following code segment: 


double total = 3.50; 

final double TAX_RATE = 8.5; // Tax rate in percent 
double tax = total * TAX_RATE / 100; // tax 1s 0.2975 
System.out.printInC"Total: " + total); 
System.out.printInC'Tax: " + tax); 


The output is 


Total: 3.5 
Tax: 0.2975 


You may prefer the numbers to be printed with two digits after the decimal point, like this: 


Total: 3.50 
Tax: 0.30 


You can achieve this with the printf method of the PrintStream class. (Recall that 
System.out is an instance of PrintStream.) The first parameter of the printf method is a 
format string that shows how the output should be formatted. The format string contains 
characters that are simply printed, and format specifiers: codes that start with a % character 
and end with a letter that indicates the format type. There are quite a few formats—Table 3 
shows the most important ones. The remaining parameters of printf are the values to be for- 
matted. For example, 


System.out.printfC"Total:%5.2f", total); 


prints the string Total:, followed by a floating-point number with a width of 5 and a preci- 
sion of 2. The width is the total number of characters to be printed: in our case, a space, the 
digit 3, a period, and two digits. If you increase the width, more spaces are added. The preci- 
sion is the number of digits after the decimal point. 

This simple use of printf is sufficient for most formatting needs. Once in a while, you 
may see a more complex example, such as this one: 


System. out.printf("%-65%5.2f%n", "“Tax:", total); 


Here, we have three format specifiers. The first one is %-6s. The s indicates a string. The 
hyphen is a flag, modifying the format. (See Table 4 for the most common format flags. The 
flags immediately follow the % character.) The hyphen indicates left alignment. If the string 
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Table 3 Format Types 


Code Type Example 
d Decimal integer 123 
x Hexadecimal integer 7B 
o Octal integer 173 
f Fixed floating-point 12.30 
e Exponential floating-point 1.23e+1 
g General floating-point 12.3 


(exponential notation used for 
very large or very small values) 


S String Tax: 


n Platform-independent line end 


to be formatted is shorter than the width, it is placed to the left, and spaces are added to the 
right. (The default is right alignment, with spaces added to the left.) Thus, %-6s denotes a 
left-aligned string of width 6. 

You have already seen %5.2f: a floating-point number of width 5 and precision 2. The 
final specifier is %n, indicating a platform-independent line end. In Windows, lines need to be 
terminated by two characters: a carriage return '\r' and a newline '\n'. In other operating 
systems, a '\n' suffices. The %n format emits the appropriate line terminators. 

Moreover, this call to printf has two parameters. You can supply any number of parame- 
ter values to the printf method. Of course, they must match the format specifiers in the for- 


mat string. 
Table 4 Format Flags 
Flag Meaning Example _ 
: : Left alignment 1.23 followed by spaces 
2 Show leading zeroes 001.23 
4 Show a plus sign for positive numbers +1.23 
a Enclose negative numbers in parentheses (1.23) : 
‘ _ Show decimal separators 12, 300 


é Convert letters to uppercase 2b 
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The format method of the String class is similar to the printf method. However, it 
returns a string instead of producing output. For example, the call 


String message = String. format("Total:%5.2f", total); 


sets the message variable to the string "Total: 3.50 


ADVANCED Topic 4.7 


Using Dialog Boxes for Input and Output 


Most program users find the console window rather old-fashioned. The easiest alternative 1s 
to create a separate pop-up window for each input (see An Input Dialog Box). 

Call the static showInputDialog method of the JOptionPane class, and supply the string 
that prompts the input from the user. For example, 


String input = JOptionPane.showInputDialog("Enter price:"); 


That method returns a String object. Of course, often you need the input as a number. Use 
the Integer. parseInt and Double. parseDouble methods to convert the string to a number: 


double price = Double. parseDoubleCinput) ; 
You can also display output in a dialog box: 


JOptionPane.showMessageDialog(null, "Price: + price); 


Finally, whenever you call the showInputDialog or showMessageDialog method in a program 
that does not show any other frame windows, you need to add a line 


System.exit(0); 


to the end of your main method. The showInputDialog method starts a user interface thread 
to handle user input. When the main method reaches the end, that thread is still running, and 
your program won’t exit automatically. To force the program to exit, you need to call the 
exit method of the System class. The parameter of the exit method is the status code of the 
program. A code of 0 denotes successful completion; you can use nonzero status codes to 
denote various error conditions. 


An Input Dialog Box 
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1 


15. 


Java has eight primitive types, including four integer types and two floating- 
point types. 


. A numeric computation overflows if the result falls outside the range for the 


number type. 


. Rounding errors occur when an exact conversion between numbers is not 


possible. 


. You use a cast (typeName) to convert a value to a different type. 


Use the Math. round method to round a floating-point number to the nearest 
integer. 


A final variable is a constant. Once its value has been set, it cannot be changed. 
Use named constants to make your programs easier to read and maintain. 
Assignment to a variable is not the same as mathematical equality. 


The ++ and -- operators increment and decrement a variable. 


. If both arguments of the / operator are integers, the result is an integer and the 


remainder is discarded. 


. The % operator computes the remainder of a division. 
. The Math class contains methods sqrt and pow to compute square roots and powers. 
. A static method does not operate on an object. 


. A string is a sequence of characters. Strings are objects of the String class. 


Strings can be concatenated, that is, put end to end to yield a new longer string. 
String concatenation is denoted by the + operator. 


. Whenever one of the arguments of the + operator is a string, the other argument 


is converted to a string. 


If a string contains the digits of a number, you use the Integer. parseInt or 
Double.parseDouble method to obtain the number value. 


. Use the substring method to extract a part of a string. 
. String positions are counted starting with 0. 


. Use the Scanner class to read keyboard input in a console window. 


1. http://www .unicode.org/ The web site of the Unicode consortium. It contains char- 


acter tables that show the Unicode values of characters from many scripts. 
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CLASSES, OBJECTS, AND METHODS 


java.io.PrintStream 


printf 
java. lang.Double 

parseDoub le 
java. lang. Integer 

parseInt 

toString 

MAX_VALUE 

MIN_VALUE 
java. lang.Math 

E 

PI, 

abs 

acos 

asin 

atan 

atan2 

ceil 

cos 

exp 

floor 

log 

max 

min 

pow 

round 

sin 

sqrt 

tan 

toDegrees 

toRadians 


java.lang.String 
format 
Substring 
java. lang.System 
mn 
java.math.BigDecimal 
add 
multiply 
subtract 
java.math.BigInteger 
add 
multiply 
subtract 
java.util.Scanner 
next 
nextDouble 
nextInt 
nextLine 
javax. swing. JOptionPane 
showInputDialog 
showMessageDialog 


ke Exercise R41. Write the following mathematical expressions in Java. 


INT 


FV = PVv-(1+ NI 


c= a? +b? - 2abcosy 


7 Taye 
So + Ut + 5 gt 


P*(m, + my) 
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LO 
Exercise R4.2. Write the following Java expressions in mathematical notation. 
a. dm fl m * (Math.sqrt(l + v / c) / (Math.sqrt(1l - v / c) - 1)); 
b. volume = Math.PI * r * r * h; 
c volume = 4 * Math.PI * Math.pow(r, 3) / 3; 
d. p = Math.atan2(z, Math.sqrt(x * x + y * y)); 


Exercise R4.3. What is wrong with this version of the quadratic formula? 


x1 = (-b - Math.saqrt(b * b - 4 * a * c)) / 2 * a; 
x2 = (-b + Math.sqrt(b * b - 4 %* a * c)) Jf 2 * a; 


Exercise R4.4. Give an example of integer overflow. Would the same example work 
correctly if you used floating-point? 


Exercise R4.5. Give an example of a floating-point roundoff error. Would the same 
example work correctly if you used integers and switched to a sufficiently small 
unit, such as cents instead of dollars, so that the values don’t have a fractional part? 


Exercise R46. Consider the following code: 


CashRegister register = new CashRegister(); 
register.recordPurchase(19.93); 
register.enterPayment(20, 0, 0, 0, 0); 
System.out.printC'Change: "); 
System.out.printInCregister.giveChange()) ; 


The code segment prints the total as 0.07000000000000028. Explain why. Give a rec- 
ommendation to improve the code so that users will not be confused. 
Exercise R4.7. Let n be an integer and x a floating-point number. Explain the differ- 
ence between 

n = (int) x; 
and 

n = Cint) Math. round(x); 
Exercise R4.8. Let n be an integer and x a floating-point number. Explain the differ- 
ence between 

n= Cint) (x + 0.5); 
and 

n = (int) Math. round(x); 
For what values of x do they give the same result? For what values of x do they give 
different results? 
Exercise R4.9. Explain the differences between 2, 2.0, '2', "2", and "2.0". 


Exercise R4.10. Explain what each of the following two program segments computes: 


int x = 2; 
int y=xX +X; 
and 


String s = "2": 
String t=S +S; 
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kx Exercise R411. True or false? (x is an int and s is a String) 
a. Integer.parseInt("" + x) 1s the same as x 
b. "" + Integer.parseInt(s) is the same as s 


c. s.substring(0, s.length()) is the same as s 


kx Exercise R4,12. How do you get the first character of a string? The last character? 
How do you remove the first character? The last character? 


kk Exercise R4.13. How do you get the last digit of an integer? The first digit? That is, if 
n is 23456, how do you find out that the first digit is 2 and the last digit is 6? Do not 
convert the number to a string. Hint: %, Math. og. 


kx Exercise R4.14. This chapter contains several recommendations regarding variables 
and constants that make programs easier to read and maintain. Summarize these 
recommendations. 


kee Exercise R445. What is a final variable? Can you define a final variable without 
supplying its value? (Try it out.) 


* — What are the values of the following expressions? In each line, 


assumé€ that 


double x = 2.5; 
double y = -1.5; 


int m = 18; 
Int n = 4; 
String s = "Hello"; 
String t = "World"; 


ax+n*y-(xe+n) * y 

bom/n+m%n 

oe 5 *x=en7 5 

d. Math.sqrt(Math. sqrt(n)) 

€e. Cint) Math. round(x) 
f. Cint) Math.round(x) + Cint) Math. round(y) 
es +t 

ho s +n 

i. 2 (Ch = (= = 1D) 

j. s.substring(1, 3) 


~ 


s.lengthQ) + t.lengthQ 


AT. Additional review exercises are available in WileyPLUS. 
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PROGRAMMING EXERCISES 


Exercise P4.1. Enhance the CashRegister class by adding separate methods 
enterDollars, enterQuarters, enterDimes, enterNickels, and enterPennies. 


Use this tester class: 


public class CashRegisterTester 


{ 
public static void main (String[] args) 
i 
CashRegister register = new CashRegister(); 
register.recordPurchase(20. 37); 
register.enterDollars(20); 
register.enterQuarters(2) ; 
System.out.printInC"Change: " + register.giveChange()); 
System.out.printInC"Expected: 0.13"); 
} 
} 


Exercise P4.2, Enhance the CashRegister class so that it keeps track of the total num- 
ber of items in a sale. Count all recorded purchases and supply a method 

int getItemCount(Q 
that returns the number of items of the current purchase. Remember to reset the 
count at the end of the purchase. 


Exercise P4.3. Implement a class IceCreamCone with methods getSurfaceArea() and 
getVolume(). In the constructor, supply the height and radius of the cone. Be careful 
when looking up the formula for the surface area—you should only include the 
outside area along the side of the cone since the cone has an opening on the top to 
hold the ice cream. 
Exercise P4.4, Write a program that prompts the user for two numbers, then prints 

e The sum 

e The difference 

e The product 

e The average 

e The distance (absolute value of the difference) 

¢ The maximum (the larger of the two) 

¢ The minimum (the smaller of the two) 
To do so, implement a class 

public class Pair 

{ 

[** 
Constructs a pair. 


@param aFirst the first value of the pair 
@param aSecond the second value of the pair 


* / 
public Pair(double aFirst, double aSecond) { ... } 


Programming Exercises 175 


/* * 
Computes the sum of the values of this sees 
@return the sum of the first and second values 


public double getSumQ) { .. . } 


Then implement a class PairTester that constructs a Pair object, invokes its 
methods, and prints the results. 


* Exercise P4.5. Define a class DataSet that computes the sum and average of a 
sequence of integers. Supply methods 


® void addValue(int x) 
® int getSumQd 
® double getAverage() 
Hint: Keep track of the sum and the count of the values. 


Then write a test program DataSetTester that calls addValue four times and prints 
the expected and actual results. 


*&* Exercise P4.6. Write a class DataSet that computes the largest and smallest values in a 
sequence of numbers. Supply methods 


® void addValue(Cint x) 
® int getLargest(Q) 
® int getSmallestQ 


Keep track of the smallest and largest values that you’ve seen so far. Then use the 
Math.min and Math.max methods to update them in the addValue method. What 
should you use as initial values? Hint: Integer .MIN_VALUE, Integer .MAX_VALUE. 


Write a test program DataSetTester that calls addValue four times and prints the 
expected and actual results. 

* Exercise P4.7. Write a program that prompts the user for a measurement in meters 
and then converts it into miles, feet, and inches. Use a class 


public class Converter 


{ 

/* * 
Constructs a converter that can convert between two units. 
@param aConversionFactor the factor by which to multiply 
to convert to the target unit 

ny 

public Converter(double aConversionFactor) { .. . } 
Converts from a source measurement to a target measurement. 
@param fromMeasurement the measurement 
@return the input value converted to the target unit 

id 


public double convertTo(Cdouble fromMeasurement) { .. . } 
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/* * 
Converts from a target measurement to a source measurement. 
@param toMeasurement the target measurement 
@return the value whose conversion is the target measurement 


public double convertFrom(double toMeasurement) { .. . } 
} 
In your ConverterTester class, construct and test the following Converter object: 


final double MILE_TO_KM = 1.609; 
Converter milesToMeters = new Converter(1000 * MILE _TO_KM); 


* Exercise P4.8. Write a class Square whose constructor receives the length of the sides. 
Then supply methods to compute 
e The area and perimeter of the square 
¢ The length of the diagonal (use the Pythagorean theorem) 
** Exercise P4.9. Implement a class SodaCan whose constructor receives the height and 


diameter of the soda can. Supply methods getVolume and getSurfaceArea. Supply a 
SodaCanTester class that tests your class. 


wk Exercise P4.10. Implement a class Balloon that models a spherical balloon that is 
being filled with air. The constructor constructs an empty balloon. Supply these 
methods: 


© void addAir(double amount) adds the given amount of air 
® double getVolume() gets the current volume 

® double getSurfaceArea() gets the current surface area 

© double getRadius() gets the current radius 


Supply a BalloonTester class that constructs a balloon, adds 100 cm? of air, tests the 
three accessor methods, adds another 100 cm 3 of air, and tests the accessor methods 
again. 


we Exercise P4.11. Grving change. Enhance the CashRegister class so that it directs a 
cashier how to give change. The cash register computes the amount to be returned 
to the customer, in pennies. 


Add the following methods to the CashRegister class: 
® int giveDollars() ® int giveNickels() 
® int giveQuarters() ® int givePennies() 
® int giveDimes() 
Each method computes the number of dollar bills or coins to return to the cus- 


tomer, and reduces the change due by the returned amount. You may assume that 
the methods are called in this order. Here is a test class: 


public class CashRegisterTester 


{ 


public static void main(String[] args) 


‘ 


kk 


tow 
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CashRegister register = new CashRegister() ; 


register.recordPurchase(8. 37) ; 

register.enterPayment(10, 0, 0, 0, 0); 
System.out.printInC"Dollars: " + register.giveDollarsQ); 
System.out.printInC"Expected: 1"); 
System.out.printInC"Quarters: " + register.giveQuarters()); 
System.out.printInC"Expected: 2"); 
System.out.printInC"Dimes: " + register.giveDimes()); 
System.out.printInC"Expected: 1"); 
System.out.printInC"Nickels: " + register.giveNickelsQ); 
System.out.printInC"Expected: 0"); 
System.out.printInC"Pennies: " + register.givePennies()); 
System.out.printInC"Expected: 3"); 


} 


Exercise P4.12. Write a program that reads in an integer and breaks it into a sequence 
of individual digits in reverse order. For example, the input 16384 is displayed as 


You may assume that the input has no more than five digits and is not negative. 
Define a class DigitExtractor: 


public class DigitExtractor 
{ 
/* % 
Constructs a digit extractor that gets the digits 
of an integer in reverse order. 
@param anInteger the integer to break up into digits 
3 
public DigitExtractor(int anInteger) { ... } 


7* % 
Returns the next digit to be extracted. 
@return the next digit 
= / 
public int nextDigitQ) { .. . } 
} 


In your main class Di gitPrinter, call System.out.printIln(myExtractor.nextDigitQ) 
five times. 


Exercise P4.13. Implement a class QuadraticEquation whose constructor receives the 
coefficients a, b, c of the quadratic equation ax* + bx + c= 0. Supply methods 
getSolution1 and getSolution2 that get the solutions, using the quadratic formula. 
Write a test class QuadraticEquationTester that constructs a Quadrati cEquation 
object, and prints the two solutions. 
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Exercise P4.14. Write a program that reads two times in military format (0900, 1730) 
and prints the number of hours and minutes between the two times. Here is a sam- 
ple run. User input is in color. 


Please enter the first time: 0900 
Please enter the second time: 1730 
8 hours 30 minutes 


Extra credit if you can deal with the case where the first time is later than the second 
time: 


Please enter the first time: 1730 
Please enter the second time: 0900 
15 hours 30 minutes 


Implement a class TimeInterval whose constructor takes two military times. The 
class should have two methods getHours and getMinutes. 


Exercise P4.15. Writing large letters. A large letter H can be produced like this: 


Use the class 


public class LetterH 


{ 
public String toString() 
{ 
return Wes *\n* e\ eRe R\ Ve ne =n 
} 
} 
Define similar classes for the letters E, L, and 0. Then write the message 
H 
= 
L 
L 
O 


in large letters. 


Exercise P4.16. Write a class ChristmasTree whose toString method yields a string 
depicting a Christmas tree: 


Remember to use escape sequences. 


tk 


k* 


(PLUS 


kok 
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Exercise P4.17. Your job is to transform numbers 1, 2, 3,. . ., 12 into the corre- 
sponding month names January, February, March, . . .,December. Implement a class 
Month whose constructor parameter is the month number and whose getName 
method returns the month name. Hint: Make a very long string "January February 
March . . . ",in which you add spaces such that each month name has the same 
length. Then use substring to extract the month you want. 


Exercise P4.18. Write a class to compute the date of Easter Sunday. Easter Sunday is 
the first Sunday after the first full moon of spring. Use this algorithm, invented by 
the mathematician Carl Friedrich Gauss in 1800: 
1. Let y be the year (such as 1800 or 2001). 
. Divide y by 19 and call the remainder a. Ignore the quotient. 
. Divide y by 100 to get a quotient b and a remainder c. 


2 

3 

4. Divide b by 4 to get a quotient d and a remainder e. 

5. Divide 8 * b + 13 by 25 to get a quotient g. Ignore the remainder. 
6 


. Divide 19 * a + b - d - g + 15 by 30 to get a remainder h. Ignore the 
quotient. 


7. Divide c by 4 to get a quotient j and a remainder k. 
8. Divide a + 11 * h by 319 to get a quotient m. Ignore the remainder. 


9. Divide 2 * 
quotient. 


e+2* j - k - h + m+ 32 by7 to get a remainder r. Ignore the 


10. 
11. Divideh - m + r +n + 19 by 32 to get a remainder p. Ignore the quotient. 


Divide h - m + r + 90 by 25 to get a quotient n. Ignore the remainder. 


Then Easter falls on day p of month n. For example, if y is 2001: 


a= 6 = 6 r= 
Db = 20 h = 18 n= 4 
c=] 1=0, kei pb = 15 
d=5, e=0 m= 0 


Therefore, in 2001, Easter Sunday fell on April 15. Write a class Easter with 
methods getEasterSundayMonth and getEasterSundayDay. 


Additional programming exercises are available in WileyPLUS. 


PROGRAMMING PROJECTS 


Project 4.1. In this project, you will perform calculations with triangles. A triangle is 
defined by the x- and y-coordinates of its three corner points. 


Your job 1s to compute the following properties of a given triangle: 


e the lengths of all sides 


e the perimeter 


e the angles at all corners e the area 
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Of course, you should implement a Triangle class with appropriate methods. Sup- 
ply a program that prompts a user for the corner point coordinates and produces a 
nicely formatted table of the triangle properties. 


This is a good team project for two students. Both students should agree on the 
Triangle interface. One student implements the Triangle class, the other simulta- 
neously implements the user interaction and formatting. 


Project 4.2. The CashRegister class has an unfortunate limitation: It is closely tied to 
the coin system in the United States and Canada. Research the system used in most 
of Europe. Your goal is to produce a cash register that works with euros and cents. 
Rather than designing another limited CashRegister implementation for the Euro- 
pean market, you should design a separate Coin class and a cash register that can 
work with coins of all types. 


ANSWERS TO SELF-CHECK QUESTIONS 


. int and double. 
. When the fractional part of x is 20.5. 
. By using a cast: (int) Math. round(x). 


. The first definition is used inside a method, the second inside a class. 


oh, Ww NO = 


. (1) You should use a named constant, not the “magic number” 3.14. 
(2) 3.14 is not an accurate representation of z. 


. The statement adds the amount value to the balance variable. 
. One less than it was before. 
. 17 and 29. 


. Only s3 is divided by 3. To get the correct result, use parentheses. Moreover, if 
sl, s2, and s3 are integers, you must divide by 3.0 to avoid integer division: 


(s1 + s2 + s3) / 3.0 


10. x? + yy? 


11. x is anumber, not an object, and you cannot invoke methods on numbers. 


Cc ay 


12. No—the print1n method is called on the object System. out. 
13. s is set to the string Agent5. 
14. The strings "i" and "ssissi". 


15. The class only has a method to read a single byte. It would be very tedious to 
form characters, strings, and numbers from those bytes. 


16. The value is "John". The next method reads the next word. 


Chapter 


Decisions 


. To be able to implement decisions using if statements 


nts into blocks — _ 


: To understand how to oeue ae 


ibers, © 


© fo rec ognize the correct prdating of decisions i in 
multiple branches - . | | i * 


e Te program conditions using Boolean operators and Vaables: 


To aide ae the importance of test coverage | 


The programs we have seen so far were able to do fast computations and render 
graphs, but they were very inflexible. Except for variations in the input, they 
worked the same way with every program run. One of the essential features of 
nontrivial computer programs is their ability to make decisions and to carry out 
different actions, depending on the nature of the inputs. The goal of this chapter is 


to learn how to program simple and complex decisions. 
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Computer programs often need to make decisions, taking different actions depend- 
ing on a condition. 

Consider the bank account class of Chapter 3. The withdraw method allows you 
to withdraw as much money from the account as you like. The balance just moves 
ever further into the negatives. That is not a realistic model for a bank account. Let’s 
implement the withdraw method so that you cannot withdraw more money than 

ou have in the account. That is, the withdraw method must make a decision: 
whether to allow the withdrawal or not. 

The if statement is used to implement a decision. The if state- 
ment has two parts: a condition and a body. If the condition is true, 
the body of the statement is executed. The body of the if statement 
consists of a statement: 


if Camount <= balance) 
balance = balance - amount; 
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Condition 
amount < False 
balance? True 5 gaunt < False 
balance? 
True 
Body 
, | balance =. ‘palance @ ealance< 
balance = oa Ege aa a 
balance - amount ae eneant LY 
Figure 1 Figure 2 
Flowchart for an if Statement Flowchart for an if/else Statement 


The assignment statement is carried out only when the amount to be withdrawn is 
less than or equal to the balance (see Figure 1). 

Let us make the withdraw method of the BankAccount class even more realistic. 
Most banks not only disallow withdrawals that exceed your account balance; they 
also charge you a penalty for every attempt to do so. 

This operation can’t be programmed simply by providing two complementary if 
statements, such as: 


if Camount <= balance) 


balance = balance - amount; 
if (amount > balance) // NO 
balance = balance - OVERDRAFT_PENALTY; 


There are two problems with this approach. First, if you need to modify the condi- 
tion amount <= balance for some reason, you must remember to update the 
condition amount > balance as well. If you do not, the logic of the program will no 
longer be correct. More importantly, if you modify the value of balance in the body 
of the first if statement (as in this example), then the second condition uses the new 
value. 

To implement a choice between alternatives, use the if/else statement: 


if Camount <= balance) 
balance = balance - amount; 
else 
balance = balance - OVERDRAFT_PENALTY; 


Now there is only one condition. If it is satisfied, the first statement is executed. 
Otherwise, the second is executed. The flowchart in Figure 2 gives a graphical rep- 
resentation of the branching behavior. 
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Quite often, however, the body of the if statement consists of 
multiple statements that must be executed in sequence whenever the 
condition is true. These statements must be grouped together to form 
a block statement by enclosing them in braces { }. Here is an example. 


if (amount <= balance) 


{ 


double newBalance = balance - amount; 
balance = newBalance; 


} 

A statement such as 
balance = balance - amount; 

is called a simple statement. A conditional statement such as 
if (x >= 0) y = x; 


is called a compound statement. In Chapter 6, you will encounter loop state- 
ments; they too are compound statements. 

The body of an if statement or the else alternative must be a statement —that 1s, 
a simple statement, a compound statement (such as another if statement), or a 
block statement. 


SYNTAX 5.1 The if Statement 


PAA AAA AAA AAA AAT A SNM RN NA TA A MS NREL RRNA ER NT 


if (condition) 
statement 


if (condition) 
statement 

else 
statement 


Example: 


if Camount <= balance) 
balance = balance - amount; 


if Camount <= balance) 
balance = balance - amount; 
else 
balance = balance - OVERDRAFT_PENALTY; 


Purpose: 


To execute a statement when a condition is true or false 
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SYNTAX 5.2 Block Statement 


{ 
statement, 
statement) 
} 
Example: 
{ 
double newBalance = balance - amount; 
balance = newBalance; 
} 
Purpose: 


To group several statements together to form a single statement 


SELF CHECK 


1. Why did we use the condition amount <= balance and not amount < balance in 
the example for the if/else statement? 


2. What is logically wrong with the statement 


if Camount <= balance) 
newBalance = balance - amount; balance = newBalance; 


and how do you fix it? 


QUALITY TIP 5.1 


Brace Layout 


The compiler doesn’t care where you place braces, but we strongly recommend that you fol- 
low a simple rule: Line up { and }. 


if Camount <= balance) 


1 
double newBalance = balance - amount; 
balance = newBalance; 


} 


This scheme makes it easy to spot matching braces. 
Some programmers put the opening brace on the same line as the if: 
if Camount <= balance) { 


double newBalance = balance - amount; 
balance = newBalance; 
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This saves a line of code, but it makes it harder to match the braces. 
It is important that you pick a layout scheme and stick with it. Which scheme you choose 
may depend on your personal preference or a coding style guide that you must follow. 


PRODUCTIVITY HINT 5.1 


indentation and Tabs 


When writing Java programs, use indentation to indicate nesting levels: 


public class BankAccount 


: 

toe & « 

| public void withdraw(double amount) 
| ¢{ 

| | if Camount <= balance) 

| | ¢f 

| | | double newBalance = balance - amount; 
| | | balance = newBalance; 

| | 3 

a: 

| 

} 

O 42 2 3 


Indentation level 


How many spaces should you use per indentation level? Some programmers use eight spaces 
per level, but that isn’t a good choice: 


public class BankAccount 


{ 
public void withdraw(double amount) 
{ 
if Camount <= balance) 
{ 
double newBalance = 
balance - amount; 
balance = newBalance; 
} 
} 
} 


It crowds the code too much to the right side of the screen. As a consequence, long expres- 
sions frequently must be broken into separate lines. More common values are two, three, or 
four spaces per indentation level. 

How do you move the cursor from the leftmost column to the appropriate indentation 
level? A perfectly reasonable strategy is to hit the space bar a sufficient number of times. 
However, many programmers use the Tab key instead. A tab moves the cursor to the next 
tab stop. By default, there are tab stops every eight columns, but most editors let you change 
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that value; you should find out how to set your editor’s tab stops to, say, every three 
columns. 

Some editors help you out with an autoindent feature. They automatically insert as many 
tabs or spaces as the preceding line because the new line is quite likely to belong to the same 
logical indentation level. If it isn’t, you must add or remove a tab, but that is still faster than 
tabbing all the way from the left margin. 

As nice as tabs are for data entry, they have one disadvantage: They can mess up printouts. 
If you send a file with tabs to a printer, the printer may either ignore the tabs altogether or 
set tab stops every eight columns. It is therefore best to save and print your files with spaces 
instead of tabs. Most editors have settings that convert tabs to spaces before you save or print 


a file. 


ADVANCED Topic 5.1 


The Selection Operator 


Java has a selection operator of the form 
condition ? value, : value, 


The value of that expression is either value, if the condition is true or value, if it is false. For 
example, we can compute the absolute value as 


Y=xX -= 0 7 xX F =x; 
which is a convenient shorthand for 


if (x >= 0) 
y= X; 
else 
y= =A;5 


The selection operator is similar to the if/else statement, but it works on a different syntac- 
tical level. The selection operator combines values and yields another value. The if/else 
statement combines statements and yields another statement. 

For example, it would be an error to write 


y = if (x > 0) x; else -x; // Error 


The if/else construct is a statement, not a value, and you cannot assign it to a variable. 
We don’t use the selection operator in this book, but it is a convenient and legitimate con- 
struct that you will find in many Java programs. 
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1 Relational Operators 


A relational operator tests the relationship between two values. An 


Relatio erators 
example is the <= operator that we used in the test 


_ compare alues. The = oe 
Operator tests ies equality. 


if Camount <= balance) 


ies has six relational operators: 


Java Math Notation Description 
> > Greater than 
>= > Greater than or equal 
< < Less than 
<= < Less than or equal 
== = Equal 
I= - Not equal 


As you can see, only two relational operators (> and <) look as you would expect 
from the mathematical notation. Computer keyboards do not have keys for >, <, or 
#, but the >=, <=, and != operators are easy to remember because they look similar. 

The == operator is initially confusing to most newcomers to Java. In Java, the = 
symbol already has a meaning, namely assignment. The == operator denotes equal- 
ity testing: 

a= 5; // Assign5toa 

if (a == 5)... // Test whether a equals 5 
You will have to remember to use == for equality testing, and to use = for 
assignment. 


Led. Comparin. > 


You have to be careful when comparing floating-point numbers, in order to cope 
with roundoff errors. For example, the following code multiplies the square root of 
2 by itself and then subtracts 2. 


double r = Math.sqrt(2); 
double d=r* r - 2; 
ir (d. == 0) 
System.out.printInC"sqrt(2) squared minus 2 is 0"); 
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else 
System.out.printIn¢ 
"sqrt(2) squared minus 2 is not 0 but " + d); 


Z 
Even though the laws of mathematics tell us that (J/2)° -2 equals 0, this program 
fragment prints 


sqrt(2) squared minus 2 is not O but 4.440892098500626E-16 


Unfortunately, such roundoff errors are unavoidable. It plainly does not make sense 
in most circumstances to compare floating-point numbers exactly. Instead, test 
whether they are close enough. 

To test whether a number «x is close to zero, you can test whether 
the absolute value |x| (that is, the number with its sign removed) 1s 
less than a very small threshold number. That threshold value is often 
called ¢ (the Greek letter epsilon). It is common to set ¢ to 107!* when 
testing double numbers. 

Similarly, you can test whether two numbers are approximately 
equal by checking whether their difference 1s close to 0. 


Jx-y|Se 


In Java, we program the test as follows: 


final double EPSILON = 1E-14; 
if (Math.abs(x - y) <= EPSILON) 
// x is approximately equal to y 


To test whether two strings are equal to each other, you must use the method called 
equals: 


if Cstringl.equals(string2)) 
Do not use the == operator to compare strings. The expression 
if (stringl == string2) // Not useful 


has an unrelated meaning. It tests whether the two string variables 
refer to the identical string object. You can have strings with identical 
contents stored in different objects, so this test never makes sense in 
actual programming; see Common Error 5.1. 

In Java, letter case matters. For example, "Harry" and "HARRY" are not the same 
string. To ignore the letter case, use the equalsIgnoreCase method: 


if C(stringl.equalsIgnoreCase(string2) ) 


If two strings are not identical to each other, you still may want to 
know the relationship between them. The compareTo method com- 
pares strings in dictionary order. If 


stringl.compareTo(string2) < 0 
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Cc arao 


© a t hod e 


: : : 
Figure 3 Letters fr comes 


Lexicographic Comparison — match _betore t 


then the string string1 comes before the string string2 in the dictionary. For exam- 
ple, this is the case if stringl is "Harry", and string2 is "Hello". If 


Stringl.compareTo(string2) > 0 
then string1 comes after string2 in dictionary order. Finally, if 
stringl.compareTo(string2) == 0 


then stringl and string2 are equal. 

Actually, the “dictionary” ordering used by Java is slightly different from that of 
a normal dictionary. Java is case sensitive and sorts characters by putting numbers 
first, then uppercase characters, then lowercase characters. For example, 1 comes 
before B, which comes before a. The space character comes before all other 
characters. | 

Let us investigate the comparison process closely. When Java compares two 
strings, corresponding letters are compared until one of the strings ends or the first 
difference is encountered. If one of the strings ends, the longer string is considered 
the later one. If a character mismatch is found, the characters are compared to deter- 
mine which string comes later in the dictionary sequence. This process is called lex- 
icographic comparison. For example, let’s compare "car" with "cargo". The first 
three letters match, and we reach the end of the first string. Therefore "car" comes 
before "cargo" in the lexicographic ordering. Now compare "cathode" with "cargo". 
The first two letters match. In the third character position, t comes after r, so the 
string "cathode" comes after "cargo" in lexicographic ordering. (See Figure 3.) 


COMMON Error 5.1 


Using == to Compare Strings 


It is an extremely common error in Java to write == when equals is intended. This is particu- 
larly true for strings. If you write 


if Cnickname == "Rob") 


then the test succeeds only if the variable nickname refers to the exact same string object as 
the string constant "Rob". For efficiency, Java makes only one string object for every string 
constant. Therefore, the following test will pass: 


String nickname = "Rob"; 


if (nickname == "Rob") // ‘Test is true 
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However, if the string with the letters R o b has been assembled in some other way, then the 
test will fail: 


String name = "Robert"; 
String nickname = name.substring(O, 3); 


if (nickname == "Rob") // Test is false 


This is a particularly distressing situation: The wrong code will sometimes do the right thing, 
sometimes the wrong thing. Because string objects are always constructed by the compiler, 
you never have an interest in whether two string objects are shared. You must remember 
never to use == to compare strings. Always use equals or compareTo to compare strings. 


If you compare two object references with the == operator, you test whether the ref- 
erences refer to the same object. Here is an example: 
Rectangle boxl = new Rectangle(5, 10, 20, 30); 


Rectangle box2 box1; 
Rectangle box3 new Rectangle(5, 10, 20, 30); 


The comparison 
boxl == box2 

is true. Both object variables refer to the same object. But the comparison 
boxl == box3 


is false. The two object variables refer to different objects (see Figure 4). It does 
not matter that the objects have identical contents. 


Figure 4 Comparing Object References 
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You can use the equals method to test whether two rectangles 
have the same contents, that is, whether they have the same upper- 
left corner and the same width and height. For example, the test 


box1.equals (box3) 


is true. 

However, you must be careful when using the equals method. It 
works correctly only if the implementors of the class have defined it. 
The Rectangle class has an equals method that is suitable for comparing rectangles. 

For your own classes, you need to supply an appropriate equals method. You 
will learn how to do that in Chapter 10. Until that point, you should not use the 
equals method to compare objects of your own classes. 


An object reference can have the special value nu11 if it refers to no 
object at all. It is common to use the nu11 value to indicate that a 
value has never been set. For example, 


String middleInitial = null; // Notset 
i 
middleInitial = middleName.substring(O, 1); 


You use the == operator (and not equals) to test whether an object reference is a 
null reference: 
if CmiddleInitial == null) 
System.out.printIn(firstName + 


else 
System.out.printIn(firstName + 


+ lastName) ; 


+ middleInitial + + lastName) ; 


Note that the nu11 reference is not the same as the empty string "". The empty 
string is a valid string of length 0, whereas a nu11 indicates that a string variable 
refers to no string at all. 


SELF CHECK 


3. What is the value of s.lengthQ) if s is 
a. the empty string ""? 


b. the string" " containing a space? 


c. null? 


4. Which of the following comparisons are syntactically incorrect? Which of them 
are syntactically correct, but logically questionable? 


String a= “1"; 

String b = "one"; 

double x 1 

double y = 3 * (1.0 / 3); 
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a 22 "1° & 2c x 

b. a == null f. x == y 

Cc. a.equals("") g. x - y == null 
d. a == h. x.equals(y) 


QUALITY TIP 5.2 


Avoid Conditions with Side Effects 


In Java, it is legal to nest assignments inside test conditions: 
if ((d=b* b- 4 * a * c) >= 0) r = Math.sqrt(d); 


It is legal to use the decrement operator inside other expressions: 

if (n-->0O)... 
These are bad programming practices, because they mix a test with another activity. The 
other activity (setting the variable d, decrementing n) is called a side effect of the test. 


As you will see in Advanced Topic 6.2, conditions with side effects can occasionally be 
helpful to simplify loops; for if statements they should always be avoided. 


Many computations require more than a single if/else decision. Sometimes, you 
need to make a series of related comparisons. 
ee ee The following program asks for a value describing the magnitude 
Multiple conditions canbe — of an earthquake on the Richter scale and prints a description of the 
combined to evaluate = Jikely impact of the quake. The Richter scale is a measurement for 
complex decisions. The h h f h ik. 3 . h l f | 
céeeeApanuemint the strength of an earthquake. Every step in the scale, for example 
dapends on thejenic oka from 6.0 to 7.0, signifies a tenfold increase in the strength of the 
the problem to be solved. quake. The 1989 Loma Prieta earthquake that damaged the Bay 
ae Bridge in San Francisco and destroyed many buildings in several Bay 
area cities registered 7.1 on the Richter scale. 


ch05/quake/Earthquake.java 
A class that describes the effects of an earthquake. 
public class Earthquake 


{ 


wi & W ND 
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Constructs an Earthquake object. 
@param magnitude the magnitude on the Richter scale 


public Earthquake(double magnitude) 


{ 
} 


al. 
woes 


{ 


} 


richter = magnitude; 


Gets a description of the effect of the earthquake. 
@return the description of the effect 


public String getDescription() 


String r; 
if Crichter >= §.0) 

r = "Most structures fall"; 
else if Crichter >= 7.0) 

r = "Many buildings destroyed"; 
else if Crichter >= 6.0) 


r = "Many buildings considerably damaged, some collapse"; 
else if Crichter >= 4.5) 

r = "Damage to poorly constructed buildings"; 
else if Crichter >= 3.5) 

r = "Felt by many people, no destruction"; 


else if Crichter >= 0) 

r = "Generally not felt by people"; 
else 

r = "Negative numbers are not valid"; 
return r; 


private double richter; 


ch05/quake/EarthquakeRunner.java 


Ll 


import java.util.Scanner; 


‘, 4, 
RR 


This program prints a description of an earthquake of a given magnitude. 


public class EarthquakeRunner 


{ 


public static void main(String[] args) 


{ 


Scanner in = new Scanner(System.in); 


System.out.print("Enter a magnitude on the Richter scale: "): 
double magnitude = in.nextDouble(); 

Earthquake quake = new Earthquake(magnitude) ; 
System.out.println(quake.getDescription()); 
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Output 


Enter a magnitude on the Richter scale: 7.1 
Many buildings destroyed 


Here we must sort the conditions and test against the largest cutoff first. Suppose 
we reverse the order of tests: 
if C(richter >= 0) // Tests in wrong order 


r = "Generally not felt by people"; 
else if Crichter >= 3.5) 


r = "Felt by many people, no destruction"; 
else if Crichter >= 4.5) 
r = "Damage to poorly constructed buildings"; 
else if Crichter >= 6.0) 
r = "Many buildings considerably damaged, some collapse"; 


else if Crichter >= 7.0) 

r = "Many buildings destroyed" ; 
else if Crichter >= 8.0) 

r = "Most structures fall"; 


This does not work. All nonnegative values of richter fall into the first case, and the 
other tests will never be attempted. 

In this example, it is also important that we use an if/else/else test, not just 
multiple independent if statements. Consider this sequence of independent tests: 


if (richter >= 8.0) // Didn’t use else 
r = "Most structures fall"; 

if Crichter >= 7.0) 
r = "Many buildings destroyed"; 

if Crichter >= 6.0) 


r = "Many buildings considerably damaged, some collapse"; 
if Crichter >= 4.5) 

r = "Damage to poorly constructed buildings’ ; 
1f Crichter s= 3.5) 

r = "Felt by many people, no destruction’; 


if Crichter >= 0) 
r = "Generally not felt by people"; 


Now the alternatives are no longer exclusive. If richter is 6.0, then the last four 
tests all match, and r is set four times. 


PRODUCTIVITY HINT 5.2 


Keyboard Shortcuts for Mouse Operations 


Programmers spend a lot of time with the keyboard. Programs and documentation are many 
pages long and require a lot of typing. This makes you different from the average computer 
user who uses the mouse more often than the keyboard. 

Unfortunately for you, modern user interfaces are optimized for the mouse. The mouse ts 
the most obvious tool for switching between windows, and for selecting commands. The 
constant switching between the keyboard and the mouse slows you down. You need to 
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move a hand off the keyboard, locate the mouse, move the mouse, click the mouse, and move 
the hand back onto the keyboard. For that reason, most user interfaces have keyboard short- 
cuts: combinations of keystrokes that allow you to achieve the same tasks without having to 
switch to the mouse at all. 

All Microsoft Windows applications use the following conventions: 


¢ The Alt key plus the underlined letter in a menu name (such as the F in “File”) pulls down 
that menu. Inside a menu, just type the underlined character in the name of a submenu to 
activate it. For example, Alt+F followed by O selects “File” “Open”. Once your fingers 
know about this combination, you can open files faster than the fastest mouse artist. 


° Inside dialog boxes, the Tab key is important; it moves from one option to the next. The 
arrow keys move within an option. The Enter key accepts the entire dialog box, and Esc 
cancels it. 


e Ina program with multiple windows, Ctrl+Tab usually toggles through the windows 
managed by that program, for example between the source and error windows. 


¢ Alt+Tab toggles between applications, allowing you to toggle quickly between, for exam- 
ple, the text editor and a command shell window. 


¢ Hold down the Shift key and press the arrow keys to highlight text. Then use Ctrl+X to 
cut the text, Ctrl+C to copy it, and Ctrl+V to paste it. These keys are easy to remember. 
The V looks like an insertion mark that an editor would use to insert text. The X should 
remind you of crossing out text. The C is just the first letter in “Copy”. (OK, so it is also 
the first letter in “Cut” —no mnemonic rule is perfect.) You find these reminders in the 
Edit menu of most text editors. 


Take a little bit of time to learn about the keyboard shortcuts that the program designers 
provided for you, and the time investment will be repaid many times during your program- 
ming career. When you blaze through your work in the computer lab with keyboard short- 
cuts, you may find yourself surrounded by amazed onlookers who whisper, “I didn’t know 
you could do that.” 


PRODUCTIVITY HINT 5.3 


Copy and Paste in the Editor 


When you see code like 


if Crichter >= 8.0) 

r = "Most structures fall"; 
else if Crichter >= 7.0) 

r = "Many buildings destroyed"; 
else if Crichter >= 6.0) 


r = "Many buildings considerably damaged, some collapse"; 
else if Crichter >= 4.5) 

r = "Damage to poorly constructed buildings"; 
else if Crichter >= 3.5) 

r = "Felt by many people, no destruction"; 


you should think “copy and paste”. 
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Make a template: 


else if Crichter >= ) 


‘a 


and copy it. This is usually done by highlighting with the mouse and then selecting Edit and 
then Copy from the menu bar. If you follow Productivity Hint 5.2, you are smart and use 
the keyboard. Hit Shift+End to highlight the entire line, then Ctrl+C to copy it. Then paste 
it (Ctrl+V) multiple times and fill the text into the copies. Of course, your editor may use 
different commands, but the concept is the same. 

The ability to copy and paste is always useful when you have code from an example or 
another project that is similar to your current needs. To copy, paste, and modify is faster than 
to type everything from scratch. You are also less likely to make typing errors. 


ADVANCED Topic 5.2 


The switch Statement 


A sequence of if/else/else that compares a single value against several constant alternatives 
can be implemented as a switch statement. For example, 


It digit: 


switch (digit) 


{ 
case 1: System.out.printC"one"); break; 
case 2: System.out.print("two"); break; 
case 3: System.out.printC"three"); break; 
case 4: System.out.printC"four"); break; 
case 5: System.out.printC("five"); break; 
case 6: System.out.print("six"); break; 
case 7: System.out.print("seven"); break; 
case 8: System.out.printC"eight"); break; 


case 9: System.out.print("nine"); break; 
default: System.out.printC"error"); break; 


} 
This is a shortcut for 


int digit; 


if (digit == 1) System.out.print("one") ; 

else if (digit == 2) System.out.print("two") ; 
else if (digit == 3) System.out.print("three") ; 
else if (digit == 4) System.out.print(" four") ; 
else if (digit == 5) System.out.print("five") ; 
else if (digit == 6) System.out.print("six") ; 
else if (digit == 7) System.out.print("seven") ; 
else if (digit == 8) System.out.printC"eight") ; 
else if (digit == 9) System.out.print("nine"); 
else System.out.printC"error'") ; 


Using the switch statement has one advantage. It is obvious that all branches test the same 
value, namely digit. 
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The switch statement can be applied only in narrow circumstances. The test cases must be 
constants, and they must be integers, characters, or enumerated constants. You cannot use a 
switch to branch on floating-point or string values. For example, the following is an error: 


Switch (name) 


{ 


case "one": . . . break; // Error 


} 


Note how every branch of the switch was terminated by a break instruction. If the break is 
missing, execution falls through to the next branch, and so on, until finally a break or the end 
of the switch is reached. For example, consider the following switch statement: 


switch (digit) 

{ 
case 1: System.out.print("one"); // Oops—no break 
case 2: System.out.print("two"); break; 


} 


If digit has the value 1, then the statement after the case 1: label is executed. Because there 
is no break, the statement after the case 2: label is executed as well. The program prints 
“onetwo". 

There are a few cases in which this fall-through behavior is actually useful, but they are 
very rare. Peter van der Linden [1, p. 38] describes an analysis of the switch statements in the 
Sun C compiler front end. Of the 244 switch statements, each of which had an average of 7 
cases, only 3 percent used the fall-through behavior. That is, the default—falling through to 
the next case unless stopped by a break—was wrong 97 percent of the time. Forgetting to 
type the break is an exceedingly common error, yielding incorrect code. 

We leave it to you to decide whether or not to use the switch statement. At any rate, you 
need to have a reading knowledge of switch in case you find it in the code of other 
programmers. 


2 Nested Branches 


Some computations have multiple /evels of decision making. You first make one 
decision, and each of the outcomes leads to another decision. Here is a typical 
example. 

In the United States, taxpayers pay federal income tax at different rates depend- 
ing on their incomes and marital status. There are two main tax schedules: one for 
single taxpayers and one for married taxpayers “filing jointly”, meaning that the 
married taxpayers add their incomes together and pay taxes on the total. (In fact, 
there are two other schedules, “head of household” and “married filing separately”, 
which we will ignore for simplicity.) Table 1 gives the tax rate computations for 
each of the filing categories, using the values for the 1992 federal tax return. (We’re 
using the 1992 tax rate schedule in this illustration because of its simplicity. Legisla- 
tion in 1993 increased the number of rates in each status and added more compli- 
cated rules. By the time that you read this, the tax laws may well have become even 
more complex.) 
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Table 1 Federal Tax Rate Schedule (1992) 


If your filing status is Single: lf your filing status is Married: 
Tax Bracket Percentage Tax Bracket Percentage 
$0... $21,450 15% $0... $35,800 15% 

Amount over $21,450, 28% Amount over $35,800, 28% 
up to $51,900 up to $86,500 
Amount over $51,900 31% Amount over $86,500 31% 


Now let us compute the taxes due, given a filing status and an income figure. First, 
we must branch on the filing status. Then, for each filing status, we must have 
another branch on income level. 

The two-level decision process is reflected in two levels of if statements. We say 
that the income test is nested inside the test for filing status. (See Figure 5 for a 
flowchart.) 


True Single? False 
income True 15% income True 15% 
< 21,450 bracket < 35,800 bracket 
False False 
income True 28% income True 28% 
< 51,900 bracket < 86,500 bracket 
False False 
31% 31% 
bracket bracket 


Figure 5 Income Tax Computation Using 1992 Schedule 
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ch05/tax/TaxReturn.java 


l j* ¥ 
2 A tax return of a taxpayer in 1992. 
3 * / 
4 public class TaxReturn 
+ 4 
6 | ia 
7 Constructs a TaxReturn object for a given income and 
8 marital status. 
9 @param anIncome the taxpayer income 
10 @param aStatus either SINGLE or MARRIED 
11 * / 
12 public TaxReturn(double anIncome, int aStatus) 
13 { 
14 income = anIncome; 
15 status = aStatus; 
16 } 
17 
18 public double getTax() 
19 { 
20 double tax = 0; 
21 
22 if (status == SINGLE) 
23 { 
24 if Cincome <= SINGLE _BRACKET1) 
25 tax = RATE1 * income; 
26 else if (income <= SINGLE _BRACKET2) 
27 tax = RATE1 * SINGLE _BRACKET1 
28 + RATE2 * (income - SINGLE _BRACKET1); 
29 else 
30 tax = RATE1 * SINGLE BRACKETL 
31 + RATE2 * (SINGLE _BRACKET2 - SINGLE BRACKET1); 
32 + RATE3 * (income - SINGLE _BRACKET2); 
33 } 
34 else 
35 { 
36 if Cincome <= MARRIED _BRACKET1) 
37 tax = RATE1 * income; 
38 else if (income <= MARRIED BRACKET2) 
39 tax = RATE1 * MARRIED BRACKET1 
40 + RATE2 * (income - MARRIED BRACKET1); 
41 else 
42 tax = RATE1 * MARRIED BRACKET1 
43 + RATE2 * (MARRIED _BRACKET2 - MARRIED BRACKET1) ; 
44 + RATE3 * (income - MARRIED BRACKET2) ; 
45 } 
46 
47 return tax; 
48 } 
49 
50 public static final int SINGLE = 1; 
51 public static final int MARRIED = 2; 


5.3 a 


53 
54 
55 
56 
a7 
58 
59 
60 
61 
62 
63 
64 
65 } 


Multiple Alternatives 
private static final double RATE] = 0.15; 
private static final double RATE2 = 0.28; 


private static final double RATE3 = 0.31; 


private static final double SINGLE_BRACKET1 
private static final double SINGLE_BRACKET2 = 51900; 


private static final double MARRIED_BRACKET1 
private static final double MARRIED_BRACKET2 = 86500; 


private double income; 
private int status; 


ch05/tax/TaxCalculator.java 


1 import java.util.Scanner; 


ate 
ray 


{ 


Output 


This program calculates a simple tax return. 


public static void main(String[] args) 


{ 


2 
3 
4 
5 
6 public class TaxCalculator 
7 
8 
9 


Scanner in = new Scanner(System.in); 


System.out.print("Please enter your income: "); 
double income = in.nextDouble(); 


System.out.printC"Are you married? CY/N) "); 
String input = in.next(); 
int status; 
if Cinput.equalsIgnoreCase('Y'')) 
status = TaxReturn.MARRIED; 
else 
status = TaxReturn.SINGLE; 


TaxReturn alaxReturn = new TaxReturn(income, status); 


uw 


System.out.printIn(' Tax: 
+ alaxReturn.getTax()); 


Please enter your income: 50000 
Are you married? (Y/N) N 
11211.5 


Tax: 


21450; 


35800; 
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SELF CHECK 


5. The if/else/else statement for the earthquake strength first tested for higher 
values, then descended to lower values. Can you reverse that order? 


6. Some people object to higher tax rates for higher incomes, claiming that you 
might end up with /ess money after taxes when you get a raise for working hard. 
What is the flaw in this argument? 


COMMON ERROR 5.2 


The Dangling else Problem 


When an if statement is nested inside another if statement, the following error may occur. 


if Crichter >= 0) 
if Crichter <= 4) 
System.out.printInC"The earthquake is harmless"); 
else // Pitfall! 


System.out.printInC"Negative value not allowed"); 


The indentation level seems to suggest that the else is grouped with the test richter >= 0. 
Unfortunately, that is not the case. The compiler ignores all indentation and follows the rule 
that an else always belongs to the closest if, like this: 
if Crichter >= 0) 
if Crichter <= 4) 
System.out.printIn("The earthquake is harmless"); 
else // Pitfall! 
System.out.printInC"Negative value not allowed"); 


That isn’t what we want. We want to group the else with the first if. For that, we must use 
braces. 


if Crichter >= 0) 


{ 
1f Crichter <= 4) 
System.out.printInC"The earthquake is harmless"); 
t 
else 


System.out.printInC"Negative value not allowed"); 


To avoid having to think about the pairing of the else, we recommend that you always use a 
set of braces when the body of an if contains another if. In the following example, the 
braces are not strictly necessary, but they help clarify the code: 


if Crichter >= 0) 
{ 
if Crichter <= 4) 
System.out.printIn(C"The earthquake is harmless"); 
else 
System.out.printInC"Damage may occur"); 
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The ambiguous else is called a dangling else, and it is enough of a syntactical blemish that 
some programming language designers developed an improved syntax that avoids it alto- 
gether. For example, Algol 68 uses the construction 


if condition then statement else statement fi; 


The else part is optional, but since the end of the if statement is clearly marked, the group- 
ing is unambiguous if there are two ifs and only one else. Here are the two possible cases: 
if cy then if cy then s; else sy fi fi; 
if cy then if cy then s, fi else sy fi; 
By the way, fi is just if backwards. Other languages use endif, which has the same purpose 
but is less fun. 


PRODUCTIVITY HINT 5.4 


Make a Schedule and Make Time for Unexpected Problems 


Commercial software is notorious for being delivered later than promised. For example, 
Microsoft originally promised that the successor to its Windows XP operating system would 
be available in 2004, then early 1 in 2005, then late in 2005. Some of the early promises might 
not have been realistic. It is in Microsoft’s interest to let prospective customers expect the 
imminent availability of the product, so that they do not switch to a different product in 
the meantime. Undeniably, though, Microsoft had not anticipated the full complexity of the 
tasks it had set itself to solve. 

Microsoft can delay the delivery of its product, but it is likely that you cannot. As a stu- 
dent or a programmer, you are expected to manage your time wisely and to finish your 
assignments on time. You can probably do simple programming exercises the night before 
the due date, but an assignment that looks twice as hard may well take four times as long, 
because more things can go wrong. You should therefore make a schedule whenever you 
start a programming project. 

First, estimate realistically how much time it will take you to 


e Design the program logic 

e Develop test cases 

¢ Type the program in and fix syntax errors 
e Test and debug the program 


For example, for the income tax program | might estimate 30 minutes for the design, because 
it is mostly done; 30 minutes for developing test cases; one hour for data entry and fixing 
syntax errors; and 2 hours for testing and debugging. That is a total of 4 hours. If I work 2 
hours a day on this project, it will take me two days. 

Then think of things that can go wrong. Your computer might break down. The lab might 
be crowded. You might be stumped by a problem with the computer system. (That is a par- 
ticularly important concern for beginners. It is very common to lose a day over a trivial 
problem just because it takes time to track down a person who knows the “magic” command 
to overcome it.) As a rule of thumb, double the time of your estimate. That is, you should 
start four days, not two days, before the due date. If nothing goes wrong, great; you have the 
program done two days early. When the inevitable problem occurs, you have a cushion of 
time that protects you from embarrassment and failure. 
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ADVANCED TOPIC 5.3 
Enumerated Types 


In many programs, you use variables that can hold one of a finite number of values. For 
example, in the tax return class, the status field holds one of the values SINGLE or MARRIED. 
We arbitrarily defined SINGLE as the number 1 and MARRIED as 2. If, due to some program- 
ming error, the status field is set to another integer value (such as —1, 0, or 3), then the pro- 
gramming logic may produce invalid results. 

In a simple program, this is not really a problem. But as programs grow over time, and 
more cases are added (such as the “married filing separately” and “head of household” 
categories), errors can slip in. Java version 5.0 introduces a remedy: enumerated types. An 
enumerated type has a finite set of values, for example 


public enum FilingStatus { SINGLE, MARRIED } 


You can have any number of values, but you must include them all in the enum declaration. 
You can declare variables of the enumerated type: 


FilingStatus status = FilingStatus.SINGLE; 


If you try to assign a value that isn’t a FilingStatus, such as 2 or "S", then the compiler 
reports an error. 
Use the == operator to compare enumerated values, for example: 


if (status == FilingStatus.SINGLE) 
It is common to nest an enum declaration inside a class, such as 


public class TaxReturn 


{ 
public TaxReturn(double anIncome, FilingStatus aStatus) { ... } 
public enum FilingStatus { SINGLE, MARRIED } 
private FilingStatus status; 

} 


To access the enumeration outside the class in which it is defined, use the class name as a 
prefix: 


TaxReturn return = new TaxReturn(income, TaxReturn.FilingStatus. SINGLE) ; 


An enumerated type variable can be nul]. For example, the status field in the previous 
example can actually have three values: SINGLE, MARRIED, and null. This can be useful, for 
example to identify an uninitialized variable, or a potential pitfall. 


SYNTAX 5.3 Defining an Enumerated Type 


accessSpecifier enum TypeName { value,, valuer, . . . } 


Example: 
public enum FilingStatus { SINGLE, MARRIED } 


Purpose: 


To define a type with a fixed number of values 
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sing Bool 


In Java, an expression such as amount < 1000 has a value, just as the expression 
amount + 1000 has a value. The value of a relational expression is either true or 
false. For example, if amount is 500, then the value of amount < 1000 is true. Try it 
out: The program fragment 


double amount = 0; 
System.out.printInCamount < 1000); 


prints true. The values true and false are not numbers, nor are they 
objects of a class. They belong to a separate type, called boolean. The 
Boolean type is named after the mathematician George Boole (1815- 
1864), a pioneer in the study of logic. 


)Booe ORDERS LUNCH | 
/Nosore No, No, Yes 
YES, NO, NO, NOYES... 


eee 


A predicate method is a method that returns a boolean value. Here is an example of a 
predicate method: 


public class BankAccount 


{ 
public boolean isOverdrawn() 
{ 
return balance < 0; 
} 
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You can use the return value of the method as the condition of an if statement: 
if CharrysChecking.isOverdrawn() ) 

There are several useful static predicate methods in the Character class: 
isDigit 
isLetter 


1sUpperCase 
1sLowerCase 


that let you test whether a character is a digit, a letter, an uppercase letter, or a lower- 
case letter: 


if CCharacter.isUpperCase(ch) ) 


It is a common convention to give the prefix “is” or “has” to the name of a predi- 
cate method. 

The Scanner class has useful predicate methods for testing whether the next input 
will succeed. The hasNextInt method returns true if the next character sequence 
denotes an integer. It is a good idea to call that method before calling next Int: 


if Cin.hasNextIntQ)) n = in.nextIntQ; 


Similarly, the hasNextDouble method tests whether a call to nextDouble will succeed. 


Suppose you want to find whether amount is between 0 and 1000. Then two condi- 
tions have to be true: amount must be greater than 0, and it must be less than 1000. In 
Java you use the && operator to represent the and to combine test conditions. That 
is, you can write the test as follows: 


if CO < amount && amount < 1000) 


The && operator combines several tests into a new test that passes 
only when all conditions are true. An operator that combines test 
conditions is called a logical operator. 

The || (or) logical operator also combines two or more conditions. 
The resulting test succeeds if at least one of the conditions is true. For example, here 
is a test to check whether the string input is an "S" or "M": 


1f Cinput.equals("S") || input.equals("M")) 


Figure 6 shows flowcharts for these examples. 
Sometimes you need to invert a condition with the ! (not) logical operator. For 
example, we may want to carry out a certain action only if two strings are not equal: 


if C!linput.equalsc"S")) 


The ! operator takes a single condition and evaluates to true if that condition is false 
and to false if the condition is true. 
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False . False False 
0 < amount pee " ete n 
equals 'S equals "M 
True True True 
False 
amount < 100 
True 
“and” condition “or” condition 
fulfilled fulfilled 
Figure 6 Flowcharts for && and | | Combinations 
Here is a summary of the three logical operations: 
A B A&&B A 8 Alle A 1A 
true true true _— true Any true true false 
true fal se false false true true false true 


false Any false false false false 


COMMON ERROR 5.3 


Multiple Relational Operators 


Consider the expression 
if (CO < amount < 1000)... // Error 


This looks just like the mathematical notation for “amount is between 0 and 1000”. But in 
Java, it is a syntax error. 

Let us dissect the condition. The first half, 0 < amount, is a test with outcome true or 
false. The outcome of that test (true or false) is then compared against 1000. This seems to 
make no sense. Is true larger than 1000 or not? Can one compare truth values and numbers? 
In Java, you cannot. The Java compiler rejects this statement. 

Instead, use && to combine two separate tests: 


if (CO < amount && amount < 1000) . 
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Another common error, along the same lines, is to write 
if (ch == 'S' |] 'M') . .. // Error 
to test whether ch is 'S' or 'M'. Again, the Java compiler flags this construct as an error. You 


cannot apply the || operator to characters. You need to write two Boolean expressions and 
join them with the || operator: 


if (ch == 'S' || ch == 'M') . 


COMMON ERROR 5.4 
Confusing && and | | Conditions 


It is a surprisingly common error to confuse and and or conditions. A value lies between 0 
and 100 if it is at least 0 and at most 100. It lies outside that range if it is less than 0 or greater 
than 100. There is no golden rule; you just have to think carefully. 

Often the and or or is clearly stated, and then it isn’t too hard to implement it. Sometimes, 
though, the wording isn’t as explicit. It is quite common that the individual conditions are 
nicely set apart in a bulleted list, but with little indication of how they should be combined. 
The instructions for the 1992 tax return say that you can claim single filing status if any one 
of the following is true: 


e You were never married. 
¢ You were legally separated or divorced on December 31, 1992. 
¢ You were widowed before January 1, 1992, and did not remarry in 1992. 


Because the test passes if any one of the conditions is true, you must combine the conditions 
with or. Elsewhere, the same instructions state that you may use the more advantageous sta- 
tus of married filing jointly if all five of the following conditions are true: 


¢ Your spouse died in 1990 or 1991 and you did not remarry in 1992. 

* You have a child whom you can claim as dependent. 

¢ That child lived in your home for all of 1992. 

© You paid over half the cost of keeping up your home for this child. 

¢ You filed (or could have filed) a joint return with your spouse the year he or she died. 


Because all of the conditions must be true for the test to pass, you must combine them with 
an and. 


ADVANCED Topic 5.4 


Lazy Evaluation of Boolean Operators 


The && and || operators in Java are computed using /azy (or short circuit) evaluation. In other 
words, logical expressions are evaluated from left to right, and evaluation stops as soon as the 
truth value is determined. When an and 1s evaluated and the first condition 1s false, then the 
second condition is skipped—no matter what it is, the combined condition must be false. 
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When an or is evaluated and the first condition is true, the second condition is not evaluated, 
because it does not matter what the outcome of the second test is. Here is an example: 


if Cinput != null && Integer.parseInt(Cinput) > 0) 


If input is nu11, then the first condition is false, and thus the combined statement is false, no 
matter what the outcome of the second test. The second test is never evaluated if input is 
null, and there is no danger of parsing a nu11 string (which would cause an exception). 

If you do need to evaluate both conditions, then use the & and | operators (see Appendix 
E). When used with Boolean arguments, these operators always evaluate both arguments. 


ADVANCED Topic 5.5 


De Morgan’s Law 


In the preceding section, we programmed a test to see 
whether amount was between O and 1000. Let’s find out 
whether the opposite is true: 


ae optort) is : Yopited. if C!CO < amount && amount < 1000)) 


to terms joined by the ee This test is a little bit complicated, and you have to think 
or || operators. carefully through the logic. “When it is not true that 


0 < amount and amount < 1000...” Huh? It is not true that 
some people won’t be confused by this code. 

The computer doesn’t care, but humans generally have a hard time comprehending logical 
conditions with not operators applied to and/or expressions. De Morgan’s law, named after 
the mathematician Augustus de Morgan (1806-1871), can be used to simplify these Boolean 
expressions. De Morgan’s law has two forms: one for the negation of an and expression and 
one for the negation of an or expression: 


1(A && B) isthe sameas !A || !B 
'(A || B) isthe sameas !A && !B 


Pay particular attention to the fact that the and and or operators are reversed by moving the 
not inwards. For example, the negation of “the input is S or the input is M”, 


!Cinput.equals("S") || input.equals("M")) 
is “the input is not S and the input is not M” 
!input.equals("S") && !input.equals("M") 
Let us apply the law to the negation of “the amount is between 0 and 1000”: 
!€O < amount && amount < 1000) 
is equivalent to 
!¢€O < amount) || !Camount < 1000) 
which can be further simplified to 
0 >= amount || amount >= 1000 


Note that the opposite of < is >=, not >! 
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You can use a Boolean variable if you know that there are only two possible values. 
Have another look at the tax program in Section 5.3.2. The marital status 1s either 
ae or married. Instead of using an integer, you can use a variable of type boolean: 


“You can store the ou | private boolean married; 


The advantage is that you can’t accidentally store a third value in the 
variable. 
Then you can use the Boolean variable in a test: 


if (married) 


else 


Sometimes Boolean variables are called flags because they can have only two states: 
“up” and “down”. 

It pays to think carefully about the naming of Boolean variables. In our example, 
it would not be a good idea to give tie name maritalStatus to the Boolean variable. 
What does it mean that the marital status is true? With a name like married there is 
no ambiguity; if married is true, the taxpayer is married. 

By the way, it is considered gauche to write a test such as 


if (married == true)... // Dont 
Just use the simpler test 
if Cmarried) 


In Chapter 6 we will use Boolean variables to control complex loops. 


SELF CHECK 


7. When does the statement 
System.out.printIn(x > 0 || x < 0); 
print false? 
8. Rewrite the following expression, avoiding the comparison with false: 


if (Character.isDigit(ch) == false) 


RANDOM FACT 5.1 


Artificial Intelligence 


When one uses a sophisticated computer program, such as a tax preparation package, one 1s 
bound to attribute some intelligence to the computer. The computer asks sensible questions 
and makes computations that we find a mental challenge. After all, if doing our taxes were 
easy, we wouldn’t need a computer to do it for us. 
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As programmers, however, we know that all this apparent intelligence is an illusion. 
Human programmers have carefully “coached” the software in all possible scenarios, and it 
simply replays the actions and decisions that were programmed into it. 

Would it be possible to write computer programs that are genuinely intelligent in some 
sense? From the earliest days of computing, there was a sense that the human brain might be 
nothing but an immense computer, and that it might well be feasible to program computers 
to imitate some processes of human thought. Serious research into artificial intelligence (AI) 
began in the mid-1950s, and the first twenty years brought some impressive successes. Pro- 
grams that play chess—surely an activity that appears to require remarkable intellectual 
powers—have become so good that they now routinely beat all but the best human players. 
In 1975 an expert-system program called Mycin gained fame for being better in diagnosing 
meningitis in patients than the average physician. Theorem-proving programs produced log- 
ically correct mathematical proofs. Optical character recognition software can read pages 
from a scanner, recognize the character shapes (including those that are blurred or smudged), 
and reconstruct the original document text, even restoring fonts and layout. 

However, there were serious setbacks as well. From the very outset, one of the stated 
goals of the AI community was to produce software that could translate text from one lan- 
guage to another, for example from English to Russian. That undertaking proved to be enor- 
mously complicated. Human language appears to be much more subtle and interwoven with 
the human experience than had originally been thought. Even the grammar-checking pro- 
grams that come with many word processors today are more a gimmick than a useful tool, 
and analyzing grammar is just the first step in translating sentences. 

From 1982 to 1992, the Japanese government embarked on a massive research project, 
funded at over 50 billion Japanese yen. It was known as the Fifth-Generation Project. Its goal 
was to develop new hard- and software to greatly improve the performance of expert sys- 
tems. At its outset, the project created great fear in other countries that the Japanese com- 
puter industry was about to become the undisputed leader in the field. However, the end 
results were disappointing and did little to bring artificial intelligence applications to market. 

One reason that artificial intelligence programs have not performed as well as it was 
hoped seems to be that they simply don’t know as much as humans do. In the early 1990s, 
Douglas Lenat and his colleagues decided to do something about it and initiated the CYC 
project (from enCYClopedia), an effort to codify the implicit assumptions that underlie 
human speech and writing. The team members started out analyzing news articles and asked 
themselves what unmentioned facts are necessary to actually understand the sentences. For 
example, consider the sentence “Last fall she enrolled in Michigan State.” The reader auto- 
matically realizes that “fall” is not related to falling down in this context, but refers to the 
season. While there is a State of Michigan, here Michigan State denotes the university. A pri- 
ori, a computer program has none of this knowledge. The goal of the CYC project was to 
extract and store the requisite facts —that is, (1) people enroll in universities; (2) Michigan is a 
state; (3) a state X is likely to have a university named X State University, often abbreviated 
as X State; (4) most people enroll in a university in the fall. In 1995, the project had codified 
about 100,000 common-sense concepts and about a million facts relating them. Even this 
massive amount of data has not proven sufficient for useful applications. 

Successful artificial intelligence programs, such as chess-playing programs, do not actually 
imitate human thinking. They are just very fast in exploring many scenarios and have been 
tuned to recognize those cases that do not warrant further investigation. Neural networks are 
interesting exceptions: coarse simulations of the neuron cells in animal and human brains. 
Suitably interconnected cells appear to be able to “learn”. For example, if a network of cells is 
presented with letter shapes, it can be trained to identify them. After a lengthy training period, 
the network can recognize letters, even if they are slanted, distorted, or smudged. 
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When artificial intelligence programs are successful, they can raise serious ethical issues. 
There are now programs that can scan résumés, select those that look promising, and show 
only those to a human for further analysis. How would you feel if you knew that your 
résumé had been rejected by a computer, perhaps on a technicality, and that you never had a 
chance to be interviewed? When computers are used for credit analysis, and the analysis soft- 
ware has been designed to deny credit systematically to certain groups of people (say, all 
applicants with certain ZIP codes), is that illegal discrimination? What if the software has not 
been designed in this fashion, but a neural network has “discovered” a pattern from 
historical data? These are troubling questions, especially because those that are harmed by 
such processes have little recourse. 


Testing the functionality of a program without consideration of its 
internal structure is called black-box testing. This is an important 
part of testing, because, after all, the users of a program do not know 
its internal structure. If a program works perfectly on all inputs, then 
it surely does its job. 

However, it is impossible to ensure absolutely that a program will 
work correctly on all inputs just by supplying a finite number of test 
cases. As the famous computer scientist Edsger Dijkstra pointed 
out, testing can show only the presence of bugs—not their absence. 
To gain more confidence in the correctness of a program, it is useful 
to consider its internal structure. Testing strategies that look inside 
a program are called white-box testing. Performing unit tests of each 
method is a part of white-box testing. 

You want to make sure that each part of your program is exercised 


program hay e been tested. at least once by one of your test cases. This is called test coverage. It 


some code is never executed by any of your test cases, you have no 
way of knowing whether that code would perform correctly if it ever were exe- 
cuted by user input. That means that you need to look at every if/else branch to 
see that each of them is reached by some test case. Many conditional branches are in 
the code only to take care of strange and abnormal inputs, but they still do some- 
thing. It is a common phenomenon that they end up doing something incorrectly, 
but those faults are never discovered during testing, because nobody supplied the 
strange and abnormal inputs. Of course, these flaws become immediately apparent 
when the program is released and the first user types in an unusual input and is 
incensed when the program misbehaves. The remedy is to ensure that each part of 
the code is covered by some test case. 

For example, in testing the getTax method of the TaxReturn class, you want to 
make sure that every if statement is entered for at least one test case. You should 
test both single and married taxpayers, with incomes in each of the three tax brackets. 

When you select test cases, you should make it a habit to include boundary test 
cases: legal values that lie at the boundary of the set of acceptable inputs. 
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For example, what happens when you compute the taxes for an 
income of 0 or if a bank account has an interest rate of 0% ? Boundary 
cases are still legitimate inputs, and you expect that the program will 
handle them correctly —often in some trivial way or through special 
cases. Testing boundary cases is important, because programmers often 
make mistakes dealing with boundary conditions. Division by zero, extracting 
characters from empty strings, and accessing null pointers are common symptoms 
of boundary errors. 


SELF CHECK 


9. How many test cases do you need to cover all branches of the getDescription 
method of the Earthquake class? 


10. Give a boundary test case for the EarthquakeRunner program. What output do 
you expect? 


QUALITY TIP 5.3 
Calculate Sample Data Manually 


It is usually difficult or impossible to prove that a given pro- 
gram functions correctly in all cases. For gaining confidence 
in the correctness of a program, or for understanding why it 
does not function as it should, manually calculated sample 
data are invaluable. If the program arrives at the same results 
as the manual calculation, our confidence in it is strength- 
ened. If the manual results differ from the program results, 
we have a starting point for the debugging process. 

Surprisingly, many programmers are reluctant to perform any manual calculations as 
soon as a program carries out the slightest bit of algebra. Their math phobia kicks in, and 
they irrationally hope that they can avoid the algebra and beat the program into submission 
by random tinkering, such as rearranging the + and - signs. Random tinkering is always a 
great time sink, but it rarely leads to useful results. 

Let’s have another look at the TaxReturn class. Suppose a single taxpayer earns $50,000. 
The rules in Table 1 state that the first $21,450 are taxed at 15%. Expect to take out your cal- 
culator—real world numbers are usually nasty. Compute 21,450 x 0.15 = 3,217.50. Next, 
since $50,000 is less than the upper limit of the second bracket, the entire amount above 
$21,450, is taxed at 28%. That is (50,000-21,450) x 0.28 = 7,994. The total tax is the sum, 
3,217.50 + 7,994 = 11,211.50. Now, that wasn’t so hard. 

Run the program and compare the results. Because the results match, we have an 
increased confidence in the correctness of the program. 

It is even better to make manual calculations before writing the program. Doing so helps 
you understand the task at hand, and you will be able to implement your solution more 
quickly. 
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QUALITY TIP 5.4 


Prepare Test Cases Ahead of Time 


Let us consider how we can test the tax computation program. Of course, we cannot try out 
all possible inputs of filing status and income level. Even if we could, there would be no 
point in trying them all. If the program correctly computes one or two tax amounts in a 
given bracket, then we have a good reason to believe that all amounts within that bracket will 
be correct. We want to aim for complete coverage ot all cases. 

There are two possibilities for the filing status and three tax brackets for each status. That 
makes six test cases. Then we want to test error conditions, such as a negative income. That 
makes seven test cases. For the first six, we need to compute manually what answer we 
expect. For the remaining one, we need to know what error reports we expect. We write 
down the test cases and then start coding. 

Should you really test seven inputs for this simple program? You certainly should. Fur- 
thermore, if you find an error in the program that wasn’t covered by one of the test cases, 
make another test case and add it to your collection. After you fix the known mistakes, run 
all test cases again. Experience has shown that the cases that you just tried to fix are probably 
working now, but that errors that you fixed two or three iterations ago have a good chance 
of coming back! If you find that an error keeps coming back, that is usually a reliable sign 
that you did not fully understand some subtle interaction between features of your program. 

It is always a good idea to design test cases before starting to code. There are two reasons 
for this. Working through the test cases gives you a better understanding of the algorithm 
that you are about to program. Furthermore, it has been noted that programmers instinc- 
tively shy away from testing fragile parts of their code. That seems hard to believe, but you 
will often make that observation about your own work. Watch someone else test your pro- 
gram. There will be times when that person enters input that makes you very nervous 
because you are not sure that your program can handle it, and you never dared to test it 
yourself. This is a well-known phenomenon, and making the test plan before writing the 
code offers some protection. 


ADVANCED TOPIC 5.6 


Logging 


Sometimes you run a program and you are not sure where it spends its time. To get a print- 
out of the program flow, you can insert trace messages into the program, such as this one: 


public double getTax() 


© Cetatue == SINGLE) 
System.out.printInC"status is SINGLE"); 
} 
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However, there is a problem with using System.out.printin for trace messages. When you 
are done testing the program, you need to remove all print statements that produce trace 
messages. If you find another error, however, you need to stick the print statements back in. 
To overcome this problem, you should use the Logger class, which allows you to turn off 
the trace messages without removing them from the program. 
Instead of printing directly to System. out, use the global logger object Logger.global and 
call 


Logger.global.info("status is SINGLE"); 
By default, the message is printed. But if you call 
Logger.global.setLevel (Level .OFF) ; 


at the beginning of the main method of your program, all log 
message printing 1s suppressed. Thus, you can turn off the log 
messages when your program works fine, and you can turn 
them back on if you find another error. In other words, using Logger. global. info is just like 
System.out.print1n, except that you can easily activate and deactivate the logging. 

A common trick for tracing execution flow is to produce log messages when a method is 
called, and when it returns. At the beginning of a method, print out the parameters: 


public TaxReturn(Cdouble anIncome, int aStatus) 


1 


Logger.global.info(C"Parameters: anIncome = " + anIncome 


+ aStatus = " + aStatus); 


} 
At the end of a method, print out the return value: 


public double getTax() 
{ 


Logger.global.infoC"Return value = " + tax); 
return tax; 


} 


The Logger class has many other options for industrial-strength logging. Check out the API 
documentation if you want to have more control over logging. 
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CHAPTER SUMMARY 


The if statement lets a program carry out different actions depending ona 
condition. 


A block statement groups several statements together. 
Relational operators compare values. The == operator tests for equality. 


When comparing floating-point numbers, don’t test for equality. Instead, check 
whether they are close enough. 


Do not use the == operator to compare strings. Use the equals method instead. 
The compareTo method compares strings in dictionary order. 


The == operator tests whether two object references are identical. To compare 
the contents of objects, you need to use the equals method. 


The nu11 reference refers to no object. 


Multiple conditions can be combined to evaluate complex decisions. The cor- 
rect arrangement depends on the logic of the problem to be solved. 


The boolean type has two values: true and false. 
A predicate method returns a boolean value. 


You can form complex tests with the Boolean operators && (and), || (or), and ! 
(not). 


De Morgan’s law shows how to simplify expressions in which the not operator 
(1) is applied to terms joined by the && or || operators. 


You can store the outcome of a condition in a Boolean variable. 


Black-box testing describes a testing method that does not take the structure of 
the implementation into account. 


White-box testing uses information about the structure of a program. 
Test coverage is a measure of how many parts of a program have been tested. 
Boundary test cases are test cases that are at the boundary of acceptable inputs. 


You should calculate test cases by hand to double-check that your application 
computes the correct answer. 


Logging messages can be deactivated when testing 1s complete. 
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FURTHER READING 


1. Peter van der Linden, Expert C Programming, Prentice-Hall, 1994. 


2. http://ww.irs.ustreas.gov The web site of the Internal Revenue Service. 


CLASSES, OBJECTS, AND METHODS 
INTRODUCED IN THIS CHAPTER 


java. lang.Character java.lang.String java.util. logging.Logger 
1sDigit equalsIgnoreCase getLogger 
isLetter comparelo info 
1sLowerCase java.util. logging.Level setLevel 
1sUpperCase ALL java.util.Scanner 
java.lang.Object INFO hasNextDouble 
equals NONE hasNextInt 


REVIEW EXERCISES _ 


*&* Exercise R5.1. Find the errors in the following if statements. 
a. if quarters > 0 then System.out.printIn(quarters + " quarters"); 
b. if (1 + x > Math.pow(x, Math.sqrt(2)) y = y + x; 
c if (x = 1) y++; else if (x = 2) y=y +2; 
d. if & && y == 0) {x =1; y =1; } 


e. if (1 <= x <= 10) 
System.out.printIn(x); 


f. if (!s.equals("nickels") || !s.equals("pennies") 
|| !s.equalsC"dimes") || !s.equalsC"quarters")) 
System.out.printC"Input error!"); 


. 1f Cinput.equalsIgnoreCase("N") "NO") 
5 
return; 


h. int x = Integer.parseInt(input) ; 
1f (x != null) y = y + x; 


i. language = "English"; 
if Ccountry.equals(C"US")) 
if Cstate.equals("PR")) language = "Spanish"; 
else if (country.equalsC"China")) 
language = "Chinese"; 
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* Exercise R5.2. Explain the following terms, and give an example for each construct: 
a. Expression 

. Condition 

. Statement 

. Simple statement 


. Compound statement 


Block 


* Exercise R5.3. Explain the difference between an if/else if/else statement and 
nested if statements. Give an example for each. 


7 oe OO & 


* Exercise R5.4. Give an example for an if/else if/else statement where the order of 
the tests does not matter. Give an example where the order of the tests matters. 


* Exercise R5.5. Of the following pairs of strings, which comes first in lexicographic 
order? 
a. "Tom", "Dick" 


- Tom", 
. “church”, “Church tl” 


"Tomato" 


. "car manufacturer", "carburetor" 


b 
C 
d 
e. "Harry", “hairy” 
f 
h 


"C++", " Car" 

"Tom", "Tom" 

"Car", “Cart” 
Ik "car", “bar” 
. "101", “11” 


k. "1.01", "10.1" 


* Exercise R5.6. Complete the following truth table by finding the truth values of the 
Boolean expressions for all combinations of the Boolean inputs p, q, and r. 


eG or & && q) || Ir !(p && (q || rd) 
false false false : 
false - false true 


: false true, cos 


5 more combinations 
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Exercise R5.7. Before you implement any complex algorithm, it is a good idea to 
understand and analyze it. The purpose of this exercise is to gain a better under- 
standing of the tax computation algorithm of Section 5.3.2. 


One feature of the tax code is the marriage penalty. Under certain circumstances, a 
married couple pays higher taxes than the sum of what the two partners would pay 
if they both were single. Find examples for such income levels. 


Exercise R5.8. True or false? A && B is the same as B && A for any Boolean conditions 
A and B. 


Exercise R5.9. Explain the difference between 


Ss = 0: 
if (x > 0) s++4; 
if (Cy > 0) s++; 


and 
Ss = 0: 
if (x > 0) S++; 
else if (Cy > O) S++; 
Exercise R5.10. Use de Morgan’s law to simplify the following Boolean expressions. 
a !(x > 0 & y > 0) 
b. (x !=0 || y != 0) 


c. !Ccountry.equalsC"US") && !state.equalsC"HI") 
&& !state.equalsC'AK")) 


d. '(x % 4 !=0 || !( % 100 == 0 && x % 400 == 0)) 


Exercise R5.11. Make up another Java code example that shows the dangling else 
problem, using the following statement: A student with a GPA of at least 1.5, but 
less than 2, is on probation; with less than 1.5, the student is failing. 


Exercise R5.12. Explain the difference between the == operator and the equals 
method when comparing strings. 
Exercise R5.13. Explain the difference between the tests 
r== 5 
and 
r.equals(s) 
where both r and s are of type Rectangle. 
Exercise R5.14. What is wrong with this test to see whether r is nu11? What happens 
when this code runs? 
Rectangle r; 


if Cr.equals(null)) 
r = new Rectangle(5, 10, 20, 30); 
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Exercise R5.15. Explain how the lexicographic ordering of strings differs from the 
ordering of words in a dictionary or telephone book. Hint: Consider strings, such 
as IBM, wiley.com, Century 21, While-U-Wait, and 7-11. 


Exercise R5.16. Write Java code to test whether two objects of type Line2D.Double 
represent the same line when displayed on the graphics screen. Do not use 
a.equals(b). 


Line2D.Double a; 
Line2D.Double b; 


if (your condition goes here) 
g2.drawStringC("They look the same!", x, y); 
Hint: If p and q are points, then Line2D.Double(p, q) and Line2D.Double(q, p) look 
the same. 


Exercise R5.17. Explain why it is more difficult to compare floating-point numbers 
than integers. Write Java code to test whether an integer n equals 10 and whether a 
floating-point number x equals 10. 


Exercise R5.18. Consider the following test to see whether a point falls inside a 
rectangle. 


Point2D.Double p = . 

Rectangle r=... 

boolean xInside = false; 

if Cr.getXQ) <= p.getX(Q) && p.getXQ) <= r.getXQ + r.getWidth()) 
xInside = true; 

boolean yInside = false; 

if (r.getYQ <= p.getYQ && p.getYQ <= r.getYO + r.getHeight() 
yInside = true; 

if (xInside && yInside) 
g2.drawString("p is inside the rectangle.", 

p.getX(), p.getY()); 


Rewrite this code to eliminate the explicit true and false values, by setting xInside 
and yInside to the values of Boolean expressions. 


Exercise R5.19. Give a set of test cases for the earthquake program in Section 5.3.1. 
Ensure coverage of all branches. 


Exercise R5.20. Give a set of test cases for the tax program in Section 5.3.2. Compute 
the expected results manually. 


Exercise R5.21. Give an example of a boundary test case for the tax program in 
Section 5.3.2. What result do you expect? 


Additional review exercises are available in WileyPLUS. 


kk 


kn 


Programming Exercises 221 


PROGRAMMING EXERCISES 


Exercise P5.1. Write a program that prints all real solutions to the quadratic equation 
ax’ + bx + c= 0. Read in a, b, cand use the quadratic formula. If the discriminant 
b* — 4ac is negative, display a message stating that there are no real solutions. 


Implement a class QuadraticEquation whose constructor receives the coefficients a, 
b, c of the quadratic equation. Supply methods getSolution1 and getSolution2 that 
get the solutions, using the quadratic formula, or 0 if no solution exists. The 
getSolution1 method should return the smaller of the two solutions. 


Supply a method 
boolean hasSolutions() 
that returns false if the discriminant is negative. 


Exercise P5.2. Write a program that takes user input describing a playing card in the 
following shorthand notation: 


Notation Meaning 
A Ace 

2 10 Card values 

7 
K King 
D Diamonds 
H Hearts _ 
S Spades _ 
C Clabe 


Your program should print the full description of the card. For example, 


Enter the card notation: 

4S 

Four of spades 
Implement a class Card whose constructor takes the card notation string and whose 
getDescription method returns a description of the card. If the notation string 1s 
not in the correct format, the getDescription method should return the string 
"Unknown". 
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Exercise P5.3. Write a program that reads in three floating-point numbers and prints 
the three inputs in sorted order. For example: 


Please enter three numbers: 

4 

9 

265 

The inputs in sorted order are: 
2.5 

4 

9 


Exercise P5.4. Write a program that prints the question “Do you want to continue?” 
and reads a user input. If the user input is “Y”, “Yes”, “OK”, “Sure”, or “Why 
not?”, print out “OK”. If the user input is “N” or “No”, then print out “Terminat- 
ing”. Otherwise, print “Bad input”. The case of the user input should not matter. 
For example, “y” or “yes” are also valid inputs. Write a class YesNoChecker for this 
purpose. 


Exercise P5.5. Write a program that translates a letter grade into a number grade. 
Letter grades are A B C D F, possibly followed by + or -. Their numeric values are 4, 
3, 2, 1, and 0. There is no F+ or F-. A + increases the numeric value by 0.3, a - 
decreases it by 0.3. However, an A+ has the value 4.0. 


Enter a letter grade: 
Bu 
Numeric value: 2.7. 


Use a class Grade with a method getNumericGrade. 


Exercise P5.6. Write a program that translates a number into the closest letter grade. 
For example, the number 2.8 (which might have been the average of several grades) 
would be converted to B-. Break ties in favor of the better grade; for example, 2.85 


should be a B. 


Use a class Grade with a method getLetterGrade. 


Exercise P5.7, Write a program that reads in three strings and prints the lexicograph- 
ically smallest and largest one: 


Please enter three strings: 

Tom 

Dick 

Harry 

The inputs in sorted order are: 
Dick 

Harry 

Tom 


Exercise P5.8. Change the implementation of the getTax method in the TaxReturn 
class, by setting variables bracket1 and bracket2, depending on the marital status. 
Then have a single formula that computes the tax, depending on the income and the 
brackets. Verify that your results are identical to that of the TaxReturn class in this 
chapter. 
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Exercise P5.9. A year with 366 days is called a leap year. A year is a leap year if it is 
divisible by 4 (for example, 1980). However, since the introduction of the Grego- 
rian calendar on October 15, 1582, a year is not a leap year if it is divisible by 100 
(for example, 1900); however, it is a leap year if it is divisible by 400 (for example, 
2000). Write a program that asks the user for a year and computes whether that year 
is aleap year. Implement a class Year with a predicate method boolean isLeapYear(). 


Exercise P5.10. Write a program that asks the user to enter a month (1 = January, 
2 = February, and so on) and then prints the number of days of the month. For 
February, print “28 days”. 


Enter a month (1-12): 
5 
31 days 


Implement a class Month with a method int getDays(). 


Exercise P5.11. Write a program that reads in two floating-point numbers and tests 
(a) whether they are the same when rounded to two decimal places and (b) whether 
they differ by less than 0.01. Here are two sample runs. 


Enter two floating-point numbers: 

2.0 

1.99998 

They are the same when rounded to two decimal places. 
They differ by less than 0.01. 


Enter two floating-point numbers: 

0.999 

0.991 

They are different when rounded to two decimal places. 
They differ by less than 0.01. 


Exercise P5.12. Enhance the BankAccount class of Chapter 3 by 
e Rejecting negative amounts in the deposit and withdraw methods 


e Rejecting withdrawals that would result in a negative balance 


Exercise P5.13. Write a program that reads in the hourly wage of an employee. Then 
ask how many hours the employee worked in the past week. Be sure to accept frac- 
tional hours. Compute the pay. Any overtime work (over 40 hours per week) is 
paid at 150 percent of the regular wage. Solve this problem by implementing a class 
Paycheck. 


Exercise P5.14. Write a unit conversion program that asks users to identify the 
unit from which they want to convert and the unit to which they want to convert. 
Legal units are zn, ft, mi, mm, cm, m, and km. Define two objects of a class 
UnitConverter that convert between meters and a given unit. 


Convert from: 
in 

Convert to: 
mm 
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Value: 
10 
10 in = 254 mm 


Exercise P5.15. A line in the plane can be specified in various ways: 
e by giving a point (x, y) and a slope m 
e by giving two points (x1, 1), (x2, 7’) 
¢ as an equation in slope-intercept form y = mx + b 
® as an equation x = a if the line is vertical 


Implement a class Line with four constructors, corresponding to the four cases 
above. Implement methods 


boolean intersects(Line other) 
boolean equals(Line other) 
boolean isParallel(Line other) 


Exercise P5.16. Write a program that draws a circle with radius 100 and center (200, 
200). Ask the user to specify the x- and y-coordinates of a point. Draw the point as 
a small circle. If the point lies inside the circle, color the small circle green. Other- 
wise, color it red. In your exercise, define a class Circle and a method 

boolean isInside(Point2D.Double p). 


Exercise P5.17. Write a graphics program that asks the user to specify the radii of two 
circles. The first circle has center (100, 200), and the second circle has center (200, 
100). Draw the circles. If they intersect, then color both circles green. Otherwise, 
color them red. Hint: Compute the distance between the centers and compare it to 
the radu. Your program should draw nothing if the user enters a negative radius. In 
your exercise, define a class Circle and a method boolean intersects(Circle 
other). 


Additional programming exercises are available in WileyPLUS. 


PROGRAMMING PROJECTS 


Project 5.1. Implement a combination lock class. A combination lock has a dial with 
26 positions labeled A... Z. The dial needs to be set three times. If it is set to the 
correct combination, the lock can be opened. When the lock is closed again, the 
combination can be entered again. If a user sets the dial more than three times, the 
last three settings determine whether the lock can be opened. An important part of 
this exercise is to implement a suitable interface for the CombinationLock class. 


Project 5.2. Get the instructions for last year’s form 1040 from http: // 

www. irs.ustreas.gov [2]. Find the tax brackets that were used last year for all cate- 
gories of taxpayers (single, married filing jointly, married filing separately, and head 
of household). Write a program that computes taxes following that schedule. Ignore 
deductions, exemptions, and credits. Simply apply the tax rate to the income. 


Answers to Self-Check Questions 225 


ANSWERS TO SELF-CHECK QUESTIONS 


1. 


If the withdrawal amount equals the balance, the result should be a zero balance 
and no penalty. 


. Only the first assignment statement is part of the if statement. Use braces to 


group both assignment statements into a block statement. 


. (a) 0; (b) 1; (c) an exception is thrown 
. Syntactically incorrect: e, g, h. Logically questionable: a, d, f 


. Yes, if you also reverse the comparisons: 


1? Crichter < 3.5) 
r = "Generally not felt by people"; 
else if Crichter < 4.5) 


r = "Felt by many people, no destruction"; 
else if Crichter < 6.0) 
r = "Damage to poorly constructed buildings’; 


. The higher tax rate is only applied on the income in the higher bracket. Suppose 


you are single and make $51,800. Should you try to get a $200 raise? Abso- 
lutely —you get to keep 72% of the first $100 and 69% of the next $100. 


7. When x is zero. 


10. 


« if CiCharacter.isDigit(ch)) « « « 


i 


An input of 0 should yield an output of "Generally not felt by people". (If the 
output is "Negative numbers are not allowed", there is an error in the program. 


Chapter 


Iteration 


os 


To be able to program vibone with the wi le an for statements | 


To avoid infinite loops. and off-by- one errors” 


To understand r nested loops 


This chapter presents the various iteration constructs of the Java language. These 
constructs execute one or more statements repeatedly until a goal is reached. You 
will see how the techniques that you learn in this chapter can be applied to the 


processing of input data and the programming of simulations. 


reste 
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In this chapter you will learn how to write programs that repeatedly execute one or 
more statements. We will illustrate these concepts by looking at typical investment 
situations. Consider a bank account with an initial balance of $10,000 that earns 5% 
interest. The interest is computed at the end of every year on the current balance 
and then deposited into the bank account. For example, after the first year, the 
account has earned $500 (5% of $10,000) of interest. The interest gets added to the 
bank account. Next year, the interest is $525 (5% of $10,500), and the balance is 
$11,025. Table 1 shows how the balance grows in the first five years. 

How many years does it take for the balance to reach $20,000? Of course, it 
won't take longer than 20 years, because at least $500 is added to the bank account 
each year. But it will take less than 20 years, because interest is computed on 
increasingly larger balances. To know the exact answer, we will write a program that 
repeatedly adds interest until the balance is reached. 

: In Java, the while statement implements such a repetition. The 
construct 


while (condition) 
statement 


keeps executing the statement while the condition is true. 
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Table 1 Growth of an Investment 


Year Balance 
O. $10,000.00 
1 $10,500.00 
2 $11,025.00 
3 $11,576.25 
4 $12,155.06 
5 $12,762.82 


Most commonly, the statement is a block statement, that is, a set of statements 
delimited by { }. 

In our case, we want to know when the bank account has reached a particular 
balance. While the balance is less, we keep adding interest and incrementing the 
year counter: 


while (balance < targetBalance) 


{ 
years++; 
double interest = balance * rate / 100; 
balance = balance + interest; 

} 


Here is the program that solves our investment problem: 


ch06/invest1 /Investment.java 


1 7? ¥ 
2 A class to monitor the growth of an investment that 
3 accumulates interest at a fixed annual rate. 
4 ris 
5 public class Investment 
6 { 
7 Vital 
8 Constructs an Investment object from a starting balance and 
9 interest rate. 
10 @param aBalance the starting balance 
11 @param aRate the interest rate in percent 
12 * / 
13 public Investment(double aBalance, double aRate) 
14 { 
15 balance = aBalance; 
16 rate = aRate; 
17 years = 0; 
18 } 
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20 os 

21 Keeps accumulating interest until a target balance has 
22 been reached. 

23 @param targetBalance the desired balance 

24 ad 

25 public void waitForBalance(double targetBalance) 
26 { 

Z7 while (balance < targetBalance) 

28 . 

29 years++; 

30 double interest = balance * rate / 100; 
31 balance = balance + interest; 

32 } 

33 ; 

34 

35 [** 

36 Gets the current investment balance. 

37 @return the current balance 

38 a | 

39 public double getBalance() 

40 { 

4] return balance; 

42 } 

43 

44 ae 

45 Gets the number of years this investment has accumulated 
46 interest. 

47 @return the number of years since the start of the investment 
48 ud 

49 public int getYears() 

50 { 

51 return years; 

52 } 

53 . 

54 private double balance; 

55 private double rate; 

56 private int years; 

57} 


ch06/invest1/InvestmentRunner.java 


l /* ¥* 

2 This program computes how long it takes for an investment 
3 to double. 

4 * / 

5 public class InvestmentRunner 

6 { 

7 public static void main(String[] args) 

8 { 

9 final double INITIAL_BALANCE = 10000; 
10 final double RATE = 5; 
Ll Investment invest = new InvestmentCINITIAL_BALANCE, RATE); 
12 invest.waitForBalance(2 * INITIAL BALANCE) ; 


13 int years = invest.getYears(); 
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14 System.out.printiIn("The investment doubled after " 
15 + years + " years"); 

16 } 

17 } 

Output 


The investment doubled after 15 years 


A while statement is often called a loop. If you draw a flowchart, you will see that 
the control loops backwards to the test after every iteration (see Figure 1). 


The following loop, 


while (true) 
statement 
executes the statement over and over, without terminating. Whoa! Why would you 
want that? The program would never stop. There are two reasons. Some programs 
indeed never stop; the software controlling an automated teller machine, a tele- 
phone switch, or a microwave oven doesn’t ever stop (at least not until the device 1s 
turned off). Our programs aren’t usually of that kind, but even if you can’t term1- 
nate the loop, you can exit from the method that contains it. This can be helpful 
when the termination test naturally falls in the middle of the loop (see Advanced 
Topic 6.3). 


balance < False 


targetBalance 
? 


True 


Increment 
years 


Add interest 
to balance 


Figure 1 Flowchart of awhile Loop 
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SYNTAX 6.1 The while Statement 


EEN AA RENE TO OR EN ST TT IE TT 


while (condition) 


statement 
Example: 
while (balance < targetBalance) 
{ 
years++; 
double interest = balance * rate / 100; 
balance = balance + interest; 
} 
Purpose: 


To repeatedly execute a statement as long as a condition is true 


SELF CHECK 


1. How often is the following statement in the loop executed? 
while (false) statement; 


2. What would happen if RATE was set to 0 in the main method of the 
InvestmentRunner program? 


COMMON ERROR 6.1 


Infinite Loops 


The most annoying loop error is an infinite loop: a loop that runs forever and can be stopped 
only by killing the program or restarting the computer. If there are output statements in the 
loop, then reams and reams of output flash by on the screen. Otherwise, the program just sits 
there and hangs, seeming to do nothing. On some systems you can kill a hanging program by 
hitting Ctrl+Break or Ctrl+C. On others, you can close the window in which the program 
runs. 
A common reason for infinite loops is forgetting to advance the variable that controls the 
loop: 
Int years = 0; 
while (years < 20) 
{ 
double interest = balance * rate / 100; 
balance = balance + interest; 


} 


Here the programmer forgot to add a statement for incrementing years in the loop. As a 
result, the value of years always stays 0, and the loop never comes to an end. 
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Another common reason for an infinite loop is accidentally incrementing a counter that 
should be decremented (or vice versa). Consider this example: 


int years = 20; 
while (years > 0) 


{ 
years++; // Oops, should have been years-- 
double interest = balance * rate / 100; 
balance = balance + interest; 

} 


The years variable really should have been decremented, not incremented. This is a common 
error, because incrementing counters is so much more common than decrementing that your 
fingers may type the ++ on autopilot. As a consequence, years is always larger than 0, and the 
loop never terminates. (Actually, years eventually will exceed the largest representable posi- 
tive integer and wrap around to a negative number. Then the loop exits — of course, that takes 
a long time, and the result is completely wrong.) 


COMMON ERROR 6.2 


Off-by-One Errors 


Consider our computation of the number of years that are required to double an investment: 


int years = 0; 
while (balance < 2 * initialBalance) 


{ 
years++; 
double interest = balance * rate / 100; 
balance = balance + interest; 

} 


System.out.printIin( 
"The investment reached the target after " 
+ years + " years."); 


Should years start at 0 or at 1? Should you test for balance < 2 * initialBalance or for 
balance <= 2 * initialBalance? It is easy to be off by one in these expressions. 

Some people try to solve off-by-one errors by randomly inserting +1 or -1 until the pro- 
gram seems to work. That is, of course, a terrible strategy. It can take a long time to compile 
and test all the various possibilities. Expending a small amount of mental effort is a real time 
saver. 

Fortunately, off-by-one errors are easy to avoid, simply 
by thinking through a couple of test cases and using the 
information from the test cases to come up with a rationale 
for the correct loop condition. 

Should years start at O or at 1? Look at a scenario with 
simple values: an initial balance of $100 and an interest rate of 
50%. After year 1, the balance is $150, and after year 2 it is 
$225, or over $200. So the investment doubled after 2 years. The loop executed two times, 
incrementing years each time. Hence years must start at 0, not at 1. 

In other words, the balance variable denotes the balance after the end of the year. At the 
outset, the balance variable contains the balance after year 0 and not after year 1. 


“An off-by-one error isa 
“common error when 
_ programming loops. Think — 
_ to avoid this type of error. — 
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Next, should you use a < or <= comparison in the test? That is harder to figure out, 
because it 1s rare for the balance to be exactly twice the initial balance. Of course, there is one 
case when this happens, namely when the interest is 100%. The loop executes once. Now 
years is 1, and balance is exactly equal to 2 * initialBalance. Has the investment doubled 
after one year? It has. Therefore, the loop should not execute again. If the test condition is 
balance < 2 * initialBalance, the loop stops, as it should. If the test condition had been 
balance <= 2 * initialBalance, the loop would have executed once more. 

In other words, you keep adding interest while the balance has not yet doubled. 


ADVANCED TOPIC 6.1 


do Loops 


Sometimes you want to execute the body of a loop at least once and perform the loop test 
after the body was executed. The do loop serves that purpose: 


do 
statement 
while (condition) ; 


The statement is executed while the condition is true. The condition is tested after the state- 
ment is executed, so the statement is executed at least once. 

For example, suppose you want to make sure that a user enters a positive number. As long 
as the user enters a negative number or zero, just keep prompting for a correct input. In this 
situation, a do loop makes sense, because you need to get a user input before you can test it. 


double value; 
do 
{ 


System.out.print("Please enter a positive number: "); 
value = in.nextDouble() ; 


} 


while (value <= 0); 


The figure shows a flowchart of this loop. 


Read val ue 


Flowchart of a do Loop 
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In practice, this situation is not very common. You can always replace a do loop with a 
while loop, by introducing a boolean control variable. 


boolean done = false; 
while (!done) 
{ 


System.out.print("Please enter a positive number: "); 
value = in.nextDouble(); 
if (value > 0) done = true; 


RANDOM FACT 6.1 


Spaghetti Code 


In this chapter we are using flowcharts to illustrate the behavior of the loop statements. It 
used to be common to draw flowcharts for every method, on the theory that flowcharts were 
easier to read and write than the actual code (especially in the days of machine-language and 
assembler programming). Flowcharts are no longer routinely used for program development 
and documentation. 

Flowcharts have one fatal flaw. Although it is possible to express the while and do loops 
with flowcharts, it is also possible to draw flowcharts that cannot be programmed with 
loops. Consider the chart in the Spaghetti Code figure. The top of the flowchart is simply a 


statement 
years = 1; 
The lower part is a do loop: 


do 
{ 


years++; 
double interest = balance * rate / 100; 
balance = balance + interest; 


} 


while (balance < targetBalance) ; 


But how can you join these two parts? According to the flowchart, you are supposed to 
jump from the first statement into the middle of the loop, skipping the first statement. 


years = 1; 
goto a; // Notan actual Java statement 
do 
{ 
years++; 
a: 


double interest = balance * rate / 100; 
balance = balance + interest; 


} 


while (balance < targetBalance) ; 
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years = 1 


years++ 


Add interest 
to balance 


True balance < 
targetBalance 
soe 


False 


Spaghetti Code 


In fact, why even bother with the do loop? Here is a faithful interpretation of the flowchart: 


years = 1; 

goto a; // Not an actual Java statement 
b: 

years++; 

a: 


double interest = balance * rate / 100; 
balance = balance + interest; 
if (balance < targetBalance) goto b; 


This nonlinear control flow turns out to be extremely hard to read and understand if you 
have more than one or two goto statements. Because the lines denoting the goto statements 
weave back and forth in complex flowcharts, the resulting code is named spaghetti code. 

In 1968 the influential computer scientist Edsger Dijkstra wrote a famous note, entitled 
“Goto Statements Considered Harmful” [1], in which he argued for the use of loops instead 
of unstructured jumps. Initially, many programmers who had been using goto for years were 
mortally insulted and promptly dug out examples in which the use of goto led to clearer or 
faster code. Some languages offer weaker forms of goto that are less harmful, such as the 
break statement in Java, discussed in Advanced Topic 6.4. Nowadays, most computer scien- 
tists accept Diykstra’s argument and fight bigger battles than optimal loop design. 
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BS) 


One of the most common loop types has the form 


1 = Start; 
while (i <= end) 
{ 
1++; 
} 


Because this loop is so common, there is a special form for it that emphasizes the 
pattern: 


for (i = start: i <= end; i++) 


{ 


} 


You can also declare the loop counter variable inside the for loop header. That con- 
venient shorthand restricts the use of the variable to the body of the loop (as will be 
discussed further in Advanced Topic 6.2). 


for (int i = start; i <= end; i++) 


{ 


} 


Let us use this loop to find out the size of our $10,000 investment if 5% interest is 
compounded for 20 years. Of course, the balance will be larger than $20,000, 
because at least $500 is added every year. You may be surprised to find out just how 
much larger the balance is. 


SYNTAX 6.2 The for Statement 


for (initialization; condition; update) 


statement 

Example: 

for (i = 1; 7 <= n; i++) 

: 
double interest = balance * rate / 100; 
balance = balance + interest; 

} 

Purpose: 


To execute an initialization, then keep executing a statement and updating an expression 
while a condition is true 
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In our loop, we let i go from 1 to n, the number of years for which 


You use a for loop whena 
we want to compound interest. 


variable runs froma 


Starting to an ending value for Cint i = 1: i <= n; i++) 
with a constant increment { 
or decrement. double interest = balance * rate / 100; 


balance = balance + interest; 


} 


Figure 2 shows the corresponding flowchart. 
The three slots in the for header can contain any three expressions. You can 


count down instead of up: 
for (years =n; years > 0; years--) 
The increment or decrement need not be in steps of 1: 


for (x = -10; x <= 10; x = x + 0.5) 


ed 
ee False 
True 


Add interest 
to balance 


1++ 


Figure 2 Flowchart of a for Loop 


6.2 « for Loops 239 


It is possible—but a sign of unbelievably bad taste—to put unrelated conditions 
into the loop header: 


for Crate = 5; years-- > 0; System.out.printIn(balance) ) 
. // Bad taste 


We won’t even begin to decipher what that might mean. You should stick with for 
loops that initialize, test, and update a single variable. 


ch06/invest2/Investment.java 


l [** 
2 A class to monitor the growth of an investment that 
3 accumulates interest at a fixed annual rate. 
4 */ 
5 ~=public class Investment 
6 { 
7 [** 
8 Constructs an Investment object from a starting balance and 
9 interest rate. 
10 @param aBalance the starting balance 
11 @param aRate the interest rate in percent 
12 * / 
13 public Investment(double aBalance, double aRate) 
14 { 
15 balance = aBalance; 
16 rate = aRate; 
17 years = 03 
18 } 
19 
20 i 
ral Keeps accumulating interest until a target balance has 
22 been reached. 
23 @param targetBalance the desired balance 
24 * / 
25 public void waitForBalance(double targetBalance) 
26 { 
27 while (balance < targetBalance) 
28 1 
29 years++; 
30 double interest = balance * rate / 100; 
31 balance = balance + interest; 
32 i 
33 } 
34 
35 [e* 
36 Keeps accumulating interest for a given number of years. 
37 @param n the number of years 
38 a 
39 public void waitYears(int n) 
40 : 
41 for (int i = 13 1 <= n; i++) 
42 
43 double interest = balance * rate / |0-; 


44 balance = balance + interest; 
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45 } 

46 years = years +n; 

47 } 

48 

50 Gets the current investment balance. 
51 @return the current balance 

52 */ 

53 public double getBalance() 

54 f 

55 return balance; 

56 } 

57 

58 W4 

59 Gets the number of years this investment has accumulated 
60 interest. 

61 @return the number of years since the start of the investment 
62 * / 

63 public int getYears() 

64 { 

65 return years; 

66 } 

67 

68 private double balance; 

69 private double rate; 

70 private int years; 

71 } 


ch06/invest2/InvestmentRunner.java 
1 /* % 
2 This program computes how much an investment grows in 
a given number of years. 


3 

4 * 

5 public class InvestmentRunner 
6 

7 


public static void main(String[] args) 


8 { 
3 final double INITIAL_BALANCE = 10000; 
10 final double RATE = 5; 
11 final int YEARS = 20; 
Le Investment invest = new InvestmentC(INITIAL_BALANCE, RATE); 
13 invest.waitYears (YEARS) ; 
14 double balance = invest.getBalance(); 
15 System.out.printf("The balance after %d years is %.2f\n", 
16 YEARS, balance); 
17 } 
18 } 
Output 


The balance after 20 years is 26532.98 
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SELF CHECK 


3. Rewrite the for loop in the waitYears method as a while loop. 
4. How many times does the following for loop execute? 


for Ci = 0; i <= 10; i++) 
System.out.printInGi * 1); 


QUALITY TIP 6.1 
Use for Loops for Their Intended Purpose 


A for loop is an idiom for a while loop of a particular form. A counter runs from the start to 
the end, with a constant increment: 


for (set counter to start; test whether counter at end; 
update counter by increment) 

, & 6-3 

// counter, start, end, increment not changed here 


} 


If your loop doesn’t match this pattern, don’t use the for construction. The compiler won’t 
prevent you from writing idiotic for loops: 


// Bad style—unrelated header expressions 
for (System.out.printInC"Inputs:"); 
(x = in.nextDouble()) > 0; 
Sum = Sum + xX) 
count++; 


for Cint 1 = 1; 1 <= years; i++) 


i 
// Bad style—modifies counter 
if (balance >= targetBalance) 
j = years + 1; 
else 
{ 
double interest = balance * rate / 100; 
balance = balance + interest; 
} 
} 


These loops will work, but they are plainly bad style. Use a while loop for iterations that do 
not fit the for pattern. 
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COMMON ERROR 6.3 
Forgetting a Semicolon 


Occasionally all the work of a loop is already done in the loop header. Suppose you ignored 
Quality Tip 6.1; then you could write an investment doubling loop as follows: 


for (years = 1; 

(balance = balance + balance * rate / 100) < targetBalance; 
years++) 

System.out.printIn(years) ; 

The body of the for loop is completely empty, containing just one empty statement termi- 
nated by a semicolon. 

If you do run into a loop without a body, it is important that you make sure the semico- 
lon is not forgotten. If the semicolon is accidentally omitted, then the next line becomes part 
of the loop statement! 

for (years = 1; 

(balance = balance + balance * rate / 100) < targetBalance; 
years++) 

System.out.printIn(years) ; 


You can avoid this error by using an empty block { } instead of an empty statement. 


COMMON ERROR 6.4 
A Semicolon Too Many 


What does the following loop print? 
sum = QO; 
for (i = 1; i <= 10; i++); 
sum = sum + 1; 
System.out.printIn(Csum) ; 


Of course, this loop is supposed to compute 1 + 2 + --- + 10 = 55. But actually, the print 
statement prints 11! 

Why 11? Have another look. Did you spot the semicolon at the end of the for loop 
header? This loop is actually a loop with an empty body. 


for (i = 1; 1 <= 10; i++) 
The loop does nothing 10 times, and when it is finished, sum is still 0 and i is 11. Then the 
statement 


sum = sum + 1; 


is executed, and sum is 11. The statement was indented, which fools the human reader. But 
the compiler pays no attention to indentation. 

Of course, the semicolon at the end of the statement was a typing error. Someone’s fingers 
were so used to typing a semicolon at the end of every line that a semicolon was added to the 
for loop by accident. The result was a loop with an empty body. 
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QUALITY TIP 6.2 
Don’t Use != to Test the End of a Range 


Here is a loop with a hidden danger: 


for Ci = 1; i != n; i++) 
The test i != nis a poor idea. How does the loop behave if n happens to be zero or negative? 
The test i != nis never false, because i starts at 1 and increases with every step. 


The remedy is simple. Use <= rather than != in the condition: 


for Gi = 1; 1 <= n; 144) 


ADVANCED TOPIC 6.2 


Variables Defined in a for Loop Header 


As mentioned, it is legal in Java to declare a variable in the header of a for loop. Here is the 
most common form of this syntax: 


for Cint i = 1; 1 <= n; 144) 


: 
} 


// i no longer defined here 


The scope of the variable extends to the end of the for loop. Therefore, i is no longer defined 
after the loop ends. If you need to use the value of the variable beyond the end of the loop, 
then you need to define it outside the loop. In this loop, you don’t need the value of i—you 
know itisn + 1 when the loop is finished. (Actually, that is not quite true—it is possible to 
break out of a loop before its end; see Advanced Topic 6.4). When you have two or more exit 
conditions, though, you may still need the variable. For example, consider the loop 


for (i = 1; balance < targetBalance && i <= n; i++) 


{ 
} 


You want the balance to reach the target, but you are willing to wait only a certain number of 
years. If the balance doubles sooner, you may want to know the value of i. Therefore, in this 
case, It is not appropriate to define the variable in the loop header. 

Note that the variables named i in the following pair of for loops are independent: 


for (int 1 = 1; 71 <= 10; i++) 
System.out.printIn(@i * 1); 

for (int i = 1; i <= 10; i++) // Declares a new variable i 
system.out.printing] * 7 * 1); 
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In the loop header, you can declare multiple variables, as long as they are of the same type, 
and you can include multiple update expressions, separated by commas: 

for Cint i = 0, j = 10; i <= 10; i++, j--) 

{ 


Z 


However, many people find it confusing if a for loop controls more than one variable. I rec- 
ommend that you not use this form of the for statement (see Quality Tip 6.1). Instead, make 
the for loop control a single counter, and update the other variable explicitly: 


int j = 10; 
for Cint i = 0; 1 <= 10; i++) 


Sometimes, the body of a loop is again a loop. We say that the inner 
loop is nested inside an outer loop. This happens often when you 
process two-dimensional structures, such as tables. 

Let’s look at an example that looks a bit more interesting than a 
table of numbers. We want to generate the following triangular 
shape: 

L] 

C10] 

C10) CI 

CLICICI0) 

CICICICIC 


CICICICICIC 
CICICICICICIC 


The basic idea is simple. We generate a sequence of rows: 


for Cint i = 1; 1 <= width; i++) 
// Make triangle row 
} 


How do you make a triangle row? Use another loop to concatenate the squares [] 
for that row. Then add a newline character at the end of the row. The ith row has + 
symbols, so the loop counter goes from 1 to i. 
for Cint j = 1; j <= i; j++) 
rer¢+()'; 
r=r-¢+"\n"; 


6.3 = Nested Loops 


Putting both loops together yields two nested loops: 


String r= ; 
for Cint 1 = 1; 71 <= width; i++) 


// Make triangle row 
for (int j = 1; j <= i; j++) 
r = r - W [ ] W ; 
r=re+ "\n"; 
} 


return r; 


Here is the complete program: 


ch06/triangle1/Triangle.java 


l / * 
Z This class describes triangle objects that can be displayed 
3 as shapes like this: 
4 C] 
5 CIC] 
6 CLI). 
7 * / 
8 public class Triangle 
2 
10 i 
ll Constructs a triangle. 
12 @param aWidth the number of [] in the last row of the triangle 
13 =f 
14 public TriangleGint aWidth) 
15 { 
16 width = aWidth; 
17 } 
18 
19 por 
20 Computes a string representing the triangle. 
21 @return a string consisting of [] and newline characters 
22 ny 
23 public String toStringQ 
24 { 
25 String r= °": 
26 for Gint 1 = 1; 71 <= width; i++) 
27 
28 // Make triangle row 
29 for Gint Jj = 1; j <= 1; j++) 
30 r=r+"[]"; 
31 PS C4 in" 
32 i 
33 return 1; 
34 } 
35 
36 private int width; 
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ch06/triangle1 /TriangleRunner.java 


1 
Z This program prints two triangles. 
3 « 
4 public class TriangleRunner 
> { 
6 public static void main(String[] args) 
/ { 
8 Triangle small = new Triangle(:); 
9 System.out.printIn(small.toString()); 
10 
ll Triangle large = new Triangle( 5); 
12 System.out.printIn(Clarge.toString()) ; 
13 } 
14 3} 
Output 
[J 
CIC] 
CICICI 
[J 
CIC] 
LICICI 
CICICICI 
CICICICICI 
CICICICICICI 
CICICICICICIC 
CICICICICICICICI 
CILICICICICICICICI 
CICICICICICICICICIC 


CILITIQIOICI COCO 
CICICICICICICICICI CII 
CILITICICITIQIO CCCI 0 
CICITIQICI OOOO O00 
CICICICICICICIQICICICICICICIC 


SELF CHECK 


5. How would you modify the nested loops so that you print a square instead of a 
triangle? 


6. What is the value of n after the following nested loops? 


Int n = 0; 
for Cint i = 1; 71 <= 55; i++) 
for Cint j 0; j < 13 j++) 


I 
n=n+ J; 


6.4 
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Processing Sentinel Values 


Suppose you want to process a set of values, for example a set of measurements. 
Your goal is to analyze the data and display properties of the data set, such as the 
average or the maximum value. You prompt the user for the first value, then the sec- 
ond value, then the third, and so on. When does the input end? 

One common method for indicating the end of a data set is a sentinel value, a 
value that is not part of the data. Instead, the sentinel value indicates that the data 
has come to an end. 

Some programmers choose numbers such as 0 or —1 as sentinel values. But that is 
not a good idea. These values may well be valid inputs. A better idea is to use an 
input that is not a number, such as the letter Q. Here is a typical program run: 


Enter value, Q to quit: 
Enter value, Q to quit: 
Enter value, Q to quit: 
Enter value, Q to quit: 
Enter value, Q to quit: 
Average = 2.5 

Maximum = 4.0 


OpWN 


Of course, we need to read each input as a string, not a number. Once we have 
tested that the input is not the letter Q, we convert the string into a number. 


System.out.printC"Enter value, Q to quit: "); 
String input = in.next(); 
1f Cinput.equalsIgnoreCase(""Q")) 
We are done 
else 


double x = Double.parseDouble(Cinput) ; 


Sometimes, the 
termination condition of a 
loop can only be evaluated 
in the middle of a loop. 
You can introduce a 
Boolean variable to control 
such a loop. 


Now we have another problem. The test for loop termination occurs 
in the middle of the loop, not at the top or the bottom. You must first 
try to read input before you can test whether you have reached the 
end of input. In Java, there isn’t a ready-made control structure for 
the pattern “do work, then test, then do more work”. Therefore, we 
use a combination of a while loop and a boolean variable. 


boolean done = false; 
while (!done) 
if 
Print prompt 
String input = read input; 
if (end of input indicated) 
done = true; 
else 


{ 
} 


Process input 
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This pattern is sometimes called “loop and a half”. Some programmers find it 
clumsy to introduce a control variable for such a loop. Advanced Topic 6.3 shows 
several alternatives. 

Let’s put together the data analysis program. To decouple the input handling 
from the computation of the average and the maximum, we'll introduce a class 
DataSet. You add values to a DataSet object with the add method. The getAverage 
method returns the average of all added data and the getMaximum method returns the 
largest. 


ch06/dataset/DataAnalyzer.java 


1 import java.util.Scanner; 


2 
3 . 
+ This program computes the average and maximum of a set 
5 of input values. 
& * 
7 public class DataAnalyzer 
8 { 
9 public static void main(String[] args) 
10 { 
11 Scanner in = new Scanner(System. in); 
12 DataSet data = new DataSet(); 
13 
14 boolean done = false; 
15 while (!done) 
16 { 
17 System.out.print("Enter value, Q to quit: "); 
18 String input = in.nextQ; 
19 if Cinput.equalsIgnoreCase("Q")) 
20 done = true; 
pm else 
22 { 
23 double x = Double.parseDouble(Cinput) ; 
24 data.add(x); 
25 } 
26 } 
Zt 
28 System.out.printInC("Average = " + data.getAverage(); 
29 System.out.printIn("Maximum = " + data.getMaximum()) ; 
30 } 
31 } 


ch06/dataset/DataSet.java 
7 we 


Computes information about a set of data values. 
* / 
public class DataSet 
{ 


wi f W NS pt 
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6 [** 
7 Constructs an empty data set. 
8 ~ 
9 public DataSet() 
10 { 
11 sum = (0; 
12 count = 0; 
13 maximum = 0; 
14 } 
15 
16 wa 
17 Adds a data value to the data set. 
18 @param x a data value 
19 * / 
20 public void add(double x) 
21 { 
22 sum = sum + x; 
23 if (count == 9 || maximum < x) maximum = x; 
24 count++; 
25 } 
26 
ra [wr 
28 Gets the average of the added data. 
29 @return the average or 0 if no data has been added 
30 ars 
31 public double getAverage() 
$2 : 
33 if (count == 0) return 0; 
34 else return sum / count; 
35 ; 
36 
37 [*% 
38 Gets the largest of the added data. 
39 @return the maximum or 0 if no data has been added 
40 * / 
41 public double getMaximum() 
42 { 
43 return maximum; 
44 } 
45 
46 private double sum; 
47 private double maximum; 
48 private int count; 
49 } 
Output 


Enter value, Q to quit: 10 
Enter value, Q to quit: 0 

Enter value, Q to quit: -1 
Enter value, Q to quit: Q 

Average = 3.0 

Maximum = 10.0 
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SELF CHECK 


ve Why does the DataAnalyzer class call in.next and not in.nextDouble? 


8. Would the DataSet class still compute the correct maximum if you simplified 
the update of the maximum field in the add method to the following statement? 


if (maximum < x) maximum = x; 


How To 6.1 


Implementing Loops 


You write a loop because your program needs to repeat an action multiple times. As you 
have seen in this chapter, there are several loop types, and it isn’t always obvious how to 
structure loop statements. This How To walks you through the thought process that 1s 
involved when programming a loop. 


Step 1 List the work that needs to be done in every step of the loop body. 

For example, suppose you need to read in input values in gallons and convert them to liters 
until the end of input is reached. Then the operations are: 

e Read input. 

¢ Convert the input to liters. 

e Print out the response. 


Suppose you need to scan through the characters of a string and count the vowels. Then the 
operations are: 


® Get the next character. 


e If it’s a vowel, increase a counter. 


Step 2. Find out how often the loop is repeated. 


Typical answers might be: 

¢ Ten times 

¢ Once for each character in the string 

e Until the end of input is reached 

¢ While the balance is less than the target balance 


If a loop is executed for a definite number of times, a for loop is usually appropriate. The 
first two answers above lead to for loops, such as 


for (int i = 1; 71 <= 10; i++) . 
for Cint 1 0; 1 < str. lengthQ); i++) 


The next two need to be implemented as while loops—you don’t know how many times the 
loop body is going to be repeated. 
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Step 3) With awhile loop, find out where you can determine that the loop is finished. 


There are three possibilities: 
e Before entering the loop 
e Inthe middle of the loop 
e At the end of the loop 
For example, if you execute a loop while the balance is less than the target balance, you can 
check for that condition at the beginning of the loop. If the balance is less than the target bal- 
ance, you enter the loop. If not, you are done. In such a case, your loop has the form 
while (condition) 


{ 
Do work 


} 


However, checking for input requires that you first read the input. That means, you’ll need 
to enter the loop, read the input, and then decide whether you want to go any further. Then 
your loop has the form 


boolean done = false; 
while (!done) 


{ 
Do the work needed to check the condition 
if (condition) 
done = true; 
else 
{ 
Do more work 
} 
} 


This loop structure is sometimes called a “loop and a half”. 
Finally, if you know whether you need to go on after you have gone through the loop 
once, then you use a do/while loop: 


do 


{ 
Do work 


} 


while (condition) 


However, these loops are very rare in practice. 


Step 4 Implement the loop by putting the operations from Step 1 into the loop body. 


When you write a for loop, you usually use the loop index inside the loop body. For exam- 
ple, “get the next character” is implemented as the statement 


char ch = str.charAtG): 


Step 5 Double-check your variable initializations. 


If you use a Boolean variable done, make sure it is initialized to false. If you accumulate a 
result in a sum or count variable, make sure that you set it to 0 before entering the loop for the 
first time. 
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Step 6 Check for off-by-one errors. 


Consider the simplest possible scenarios: 
¢ If you read input, what happens if there is no input at all? Exactly one input? 


¢ If you look through the characters of a string, what happens if the string is empty? If it 
has one character in it? 


e If you accumulate values until some target has been reached, what happens if the target 1s 
O? A negative value? 


Manually walk through every instruction in the loop, including all initializations. Carefully 
check all conditions, paying attention to the difference between comparisons such as < and 
<=. Check that the loop is not traversed at all, or only once, and that the final result is what 
you expect. 

If you write a for loop, check to see whether your bounds should be symmetric or asym- 
metric (see Quality Tip 6.3), and count the number of iterations (see Quality Tip 6.4). 


QUALITY TIP 6.3 


Symmetric and Asymmetric Bounds 


It is easy to write a loop with i going from 1 to n: 
for Gi =1; 1 <= n; itt)... 


The values for i are bounded by the relation 1 < i <n. Because there are < comparisons on 
both bounds, the bounds are called symmetric. 
When traversing the characters in a string, the bounds are asymmetric. 


for (i = 0; 1 < str.lJength(Q); i++) .. . 


The values for i are bounded by 0 <i < str. JengthQ, with a 

< comparison to the left and a < comparison to the right. That 

is appropriate, because str. 1engthQ) is not a valid position. 
It is not a good idea to force symmetry artificially: 


for (i = 0; 1 <= str.lengthQ - 1; i++)... 


That is more difficult to read and understand. 
For every loop, consider which form is most natural for the problem, and use that. 


QUALITY TIP 6.4 


Count Iterations 


Finding the correct lower and upper bounds for an iteration can be confusing. Should I start 
at 0? Should I use <= b or < b as a termination condition? 

Counting the number of iterations is a very useful device 
for better understanding a loop. Counting is easier for loops 
with asymmetric bounds. The loop 


iterations th, 


for (i = a; 1 < b; i++) . 
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is executed b - a times. For example, the loop traversing the characters in a string, 
for Gi = 0; 71 < str.lJengthQ); i++) 


runs str.length() times. That makes perfect sense, because there are str. 1ength() charac- 
ters in a string. 
The loop with symmetric bounds, 


for (i = a; 1 <= b; i++) 


is executed b - a + 1 times. That “+ 1” is the source of many programming errors. For 
example, 


for (n = 0; n <= 10; n++) 


runs 11 times. Maybe that is what you want; if not, start at 1 or use < 10. 
One way to visualize this “+ 1” error is to think of the posts and sections of a fence. Sup- 
pose the fence has ten sections (=). How many posts (|) does it have? 


A fence with ten sections has eleven posts. Each section has one post to the left, and there is 
one more post after the last section. Forgetting to count the last iteration of a “<=” loop is 
often called a “fence post error”. 

If the increment is a value c other than 1, and c divides b - a, then the counts are 


(b- a) /c for the asymmetric loop 
(b - a) / c +1 forthe symmetric loop 


For example, the loop for (i = 10; i <= 40; i += 5) executes (40 - 10)/5+1=7 times. 


ADVANCED ToPic 6.3 


The “Loop and a Half” Problem 


Reading input data sometimes requires a loop such as the following, which is somewhat 
unsightly: 


boolean done = false; 
while (!done) 


f 
String input = in.next(); 
if Cinput.equalsIgnoreCase("Q")) 
done = true; 
else 
{ 
Process data 
} 
} 


The true test for loop termination is in the middle of the loop, not at the top. This is called a 
“loop and a half”, because one must go halfway into the loop before knowing whether one 
needs to terminate. 
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Some programmers dislike the introduction of an additional Boolean variable for loop 
control. Two Java language features can be used to alleviate the “loop and a halt” problem. I 
don’t think either is a superior solution, but both approaches are fairly common, so it 1s 
worth knowing about them when reading other people’s code. 

You can combine an assignment and a test in the loop condition: 


while (!Cinput = in.nextQ)).equalsIgnoreCase("Q")) 


Process data 


} 
The expression 
(input = in.next()).equalsIgnoreCase("Q") 


means, “First call in.nextQ, then assign the result to input, then test whether it equals "Q"”. 
This is an expression with a side effect. The primary purpose of the expression is to serve as a 
test for the while loop, but it also does some work—namely, reading the input and storing it 
in the variable input. In general, it is a bad idea to use side effects, because they make a pro- 
eram hard to read and maintain. In this case, however, that practice is somewhat seductive, 
because it eliminates the control variable done, which also makes the code hard to read and 
maintain. 

The other solution is to exit the loop from the middle, either by a return statement or by 
a break statement (see Advanced Topic 6.4). 


public void processInput(Scanner in) 


{ 


while (true) 
{ 


String input = in.next(); 

if Cinput.equalsIgnoreCase('"Q")) 
return; 

Process data 


ADVANCED TOPIC 6.4 


The break and continue Statements 


You already encountered the break statement in Advanced Topic 5.2, where it was used to 
exit a switch statement. In addition to breaking out of a switch statement, a break statement 
can also be used to exit a while, for, or do loop. For example, the break statement in the fol- 
lowing loop terminates the loop when the end of input is reached. 


while (true) 
‘ 
String input = in.next(); 
if Cinput.equalsIgnoreCase("Q")) 
break; 
double x = Double.parseDoubleCinput) ; 
data.add(x) ; 
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In general, a break is a very poor way of exiting a loop. In 1990, a misused break caused an 
AT&T 4ESS telephone switch to fail, and the failure propagated through the entire U.S. net- 
work, rendering it nearly unusable for about nine hours. A programmer had used a break to 
terminate an if statement. Unfortunately, break cannot be used with if, so the program exe- 
cution broke out of the enclosing switch statement, skipping some variable initializations 
and running into chaos [2, p. 38]. Using break statements also makes it difficult to use cor- 
rectness proof techniques (see Advanced Topic 6.5). 

However, when faced with the bother of introducing a separate loop control variable, 
some programmers find that break statements are beneficial in the “loop and a half” case. 
This issue is often the topic of heated (and quite unproductive) debate. In this book, we 
won’t use the break statement, and we leave it to you to decide whether you like to use it in 
your own programs. 

In Java, there is a second form of the break statement that is used to break out of a nested 
statement. The statement break /abel; immediately jumps to the end of the statement that is 
tagged with a label. Any statement (including if and block statements) can be tagged with a 
label—the syntax is 


label: statement 


The labeled break statement was invented to break out of a set of nested loops. 


outer loop: 
while (outer loop condition) 


oe. wh 

while (inner loop condition) 

t= & 6 

if (something really bad happened) 
break outer loop; 


; 


} 
Jumps here if something really bad happened 


Naturally, this situation is quite rare. We recommend that you try to introduce additional 
methods instead of using complicated nested loops. 

Finally, there is another goto-like statement, the continue statement, which jumps to the 
end of the current iteration of the loop. Here is a possible use for this statement: 


while (! done) 
{ 
String input = in.next(); 
if Cinput.equalsIgnoreCase("Q")) 
{ 
done = true; 
continue; // Jump to the end of the loop body 
} 
double x = Double.parseDouble(Cinput) ; 
data.add(x) ; 
// continue statement jumps here 


} 


By using the continue statement, you don’t need to place the remainder of the loop code 
inside an else clause. This is a minor benefit. Few programmers use this statement. 
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b 


In a simulation you generate random events and evaluate their out- 
comes. Here is a typical problem that can be decided by running a sim- 
ulation: the Buffon needle experiment, devised by Comte Georges- 
Louis Leclerc de Buffon (1707-1788), a French naturalist. On each 
try, a one-inch long needle is dropped onto paper that is ruled with 
lines 2 inches apart. If the needle drops onto a line, count it as a hit. 
(See Figure 3.) Buffon conjectured that the quotient tries/hits approximates 2. 

Now, how can you run this experiment in the computer? You don’t actually 
want to build a robot that drops needles on paper. The Random class of the Java 
library implements a random number generator, which produces numbers that 
appear to be completely random. To generate random numbers, you construct an 
object of the Random class, and then apply one of the following methods: 


Method Returns 
nextInt(n) A random integer between the integers 0 (inclusive) and n (exclusive) 


nextDouble() A random floating-point number between 0 (inclusive) and 1 (exclusive) 


For example, you can simulate the cast of a die as follows: 


Random generator = new Random() ; 

int d = 1 + generator.nextiInt(6) ; 
The call generator.nextInt(6) gives you a random number between 0 and 5 (inclu- 
sive). Add 1 to obtain a number between 1 and 6. 

To give you a feeling for the random numbers, run the following program a few 
times. 


Figure 3 The Buffon Needle Experiment . 
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ch06/random1/Die.java 
l import java.util.Random; 


[** 


This class models a die that, when cast, lands on a random 


2 

3 

4 

5 face. 
6 vw 

7 

8 


public class Die 


1 

fe 
10 Constructs a die with a given number of sides. 
11 @param s the number of sides, e.g., 6 for a normal die 
12 * / 
13 public Die(int s) 
14 { 
15 sides = s; 
16 generator = new Random(); 
a7 } 
18 
19 [we 
20 Simulates a throw of the die. 
21 @return the face of the die 
22 * / 
23 public int castQ 
24 { 
25 return 1 + generator.nextiInt(sides) ; 
26 j 
27 
28 private Random generator; 
29 private int sides; 
30 } 


ch06/random1/DieSimulator.java 
/* * 


This program simulates casting a die ten times. 


1 

2 

3 

4 public class DieSimulator 

5 6 

6 public static void main(String[] args) 
7 { 

8 Die d = new Die(6); 

9 final int TRIES = 10; 


10 for (int i = 1; i <= TRIES; i++) 
11 { 

12 int n = d.cast(); 

13 System.out.print(n + " "); 
14 } 

15 System.out.printInQ); 

16 } 
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Typical Output 
6563263441 


Typical Output (Second Run) 
3221653412 


As you can see, this program produces a different stream of simulated die casts 
every time it is run. 

Actually, the numbers are not completely random. They are drawn from very 
long sequences of numbers that don’t repeat for a long time. These sequences are 
computed from fairly simple formulas; they just behave like random numbers. For 
that reason, they are often called pseudorandom numbers. Generating good 
sequences of numbers that behave like truly random sequences is an important and 
well-studied problem in computer science. We won’t investigate this issue further, 
though; we’ll just use the random numbers produced by the Random class. 

To run the Buffon needle experiment, we have to work a little harder. When you 
throw a die, it has to come up with one of six faces. When throwing a needle, how- 
ever, there are many possible outcomes. You must generate two random numbers: 
one to describe the starting position and one to describe the angle of the needle with 
the x-axis. Then you need to test whether the needle touches a grid line. Stop after 
10,000 tries. 

Let us agree to generate the /ower point of the needle. Its x-coordinate is irrele- 
vant, and you may assume its y-coordinate yj,,, to be any random number between 
O and 2. However, because it can be a random floating-point number, we use the 
nextDouble method of the Random class. It returns a random floating-point number 
between 0 and 1. Multiply by 2 to get a random number between 0 and 2. 

The angle a between the needle and the x-axis can be any value between 0 
degrees and 180 degrees. The upper end of the needle has y-coordinate 


ee high = Vow sin (ar) 


The needle is a hit if ypjop 1s at least 2. See Figure 4. 


Figure 4 
When Does the Needle Fall on a Line? 0 
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Here is the program to carry out the simulation of the needle experiment. 


ch06/random2/Needle.java 


1 import java.util.Random; 


2 
3 Ww 
4 This class simulates a needle in the Buffon needle experiment. 
5 * / 
6 public class Needle 
7 { 
8 /* * 
9 Constructs a needle. 
10 * / 
11 public Needle() 
12 { 
13 hits = 0; 
14 tries = 0; 
15 generator = new Random(); 
16 } 
17 
18 | a * 
19 Drops the needle on the grid of lines and 
20 remembers whether the needle hit a line. 
21 * / 
22 public void dropQ 
23 { 
24 double ylow = 2 * generator.nextDoubleQ() ; 
25 double angle = 180 * generator.nextDouble() ; 
26 
27 // Computes high point of needle 
28 
29 double yhigh = ylow + Math.sin(Math. toRadians(angle)); 
30 if (yhigh >= 2) hits++; 
31 triess+: 
32 } 
33 
34 [** 
35 Gets the number of times the needle hit a line. 
36 @return the hit count 
37 * / 
38 public int getHits() 
39 { 
40 return hits; 
41 } 
42 
43 we 
4a. Gets the total number of times the needle was dropped. 
45 @return the try count 
46 * / 
47 public int getTriesQO 
48 { 
49 return tries; 
50 } 
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52 private Random generator; 
53 private int hits; 

54 private int tries; 

55 } 


ch06/random2/NeedleSimulator.java 


L /* 

2 This program simulates the Buffon needle experiment 

3 and prints the resulting approximations of pi. 

4 */ 

5 public class NeedleSimulator 

6 { 

7 public static void main(String[] args) 

8 { 

9 Needle n = new Needle(); 
10 final int TRIES1 = 10000; 
11 final int TRIES2 = 1000000; 
12 
13 for (int i = 1; i <= TRIES1; i++) 
14 n.drop(); 
15 System.out.printf("Tries = %d, Tries / Hits = %8.5f\n", 
16 TRIES1, (double) n.getTriesQ) / n.getHits()); 
iW, 
18 for Cint i = TRIES1 + 1; i <= TRIES2; i++) 
19 n.drop(); 
20 System.out.printfC("Tries = %d, Tries / Hits = %8.5f\n", 
21 TRIES2, (double) n.getTries(Q) / n.getHits()); 
22 } 
23 } 
Output 

Tries = 10000, Tries / Hits = 3.08928 


Tries = 1000000, Tries / Hits = 3.14204 


The point of this program is not to compute z—there are far more efficient ways to 
do that. Rather, the point is to show how a physical experiment can be simulated on 
the computer. Buffon had to physically drop the needle thousands of times and 
record the results, which must have been a rather dull activity. The computer can 
execute the experiment quickly and accurately. 

Simulations are very common computer applications. Many simulations use 
essentially the same pattern as the code of this example: In a loop, a large number of 
sample values are generated, and the values of certain observations are recorded for 
each sample. When the simulation is completed, the averages, or other statistics of 
interest from the observed values are printed out. 

A typical example of a simulation is the modeling of customer queues at a bank 
or a supermarket. Rather than observing real customers, one simulates their arrival 
and their transactions at the teller window or checkout stand in the computer. One 
can try different staffing or building layout patterns in the computer simply by 
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making changes in the program. In the real world, making many such changes and 
measuring their effects would be impossible, or at least, very expensive. 


SELF CHECK 


9. How do you use a random number generator to simulate the toss of a coin? 


10. Why is the NeedleSimulator program not an efficient method for computing 2? 


ADVANCED TOPIC 6.5 


Loop Invariants 


Consider the task of computing a", where a is a floating-point number and n is a positive 
integer. Of course, you can multiplya .- a+... - a,ntimes, but if nis large, you’ll end 
up doing a lot of multiplication. The following loop computes a" in far fewer steps: 


double a=... .; 
intn=...3 
double r = 1; 
double b = a; 

int 1 =n; 


while (i > 0) 


if (i % 2 == 0) // nis even 


if 
b = b * b: 
T= 1 / Pa 
; 
else 
{ 
f = PF @ b; 
=3 
} 


// Now r equals a to the nth power 


Consider the case n = 100. The method performs the steps shown in the table below. 

Amazingly enough, the algorithm yields exactly a! a!° Do you understand why? Are you 
Sony eed at ill wor (oral aluesoea? terete claves argument to show that the method 
always computes the correct result. It demonstrates that whenever the program reaches the 
top of the while loop, it is true that 


r-b' =a (I) 
Certainly, it is true the first time around, because b = aand i = n. Suppose that (I) holds at 


the beginning of the loop. Label the values of r, b, and i as “old” when entering the loop, and 
as “new” when exiting the loop. Assume that upon entry 


1 on 
Fold “Doig 4 = a 
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Computing a!°° 

b i oot 
a 100 1 
a’ 50 
a 25 

24 a 
a® 12. 
alé 6 
a 5 

) 336 
a’ 1 

0 4100 


In the loop you must distinguish two cases: igjq even and igjg odd. If igig is even, the loop 
performs the following transformations: 


2 
Dice bold 
Tnew — lold / 2 
Therefore, 
1 2 ing /2 
new Pic a old © (bo14) 
= ig Doig 
On the other hand, if i,jq is odd, then 
new ~ ‘old ‘ bold 
a — bold 
new — 1d I 
Therefore, 
tae 
Phew | Oey aio bold bold e 
7 
=i ae 


= ql 
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In either case, the new values for r, b, and i fulfill the loop invariant (1). So what? When the 
loop finally exits, (I) holds again: 


Furthermore, we know that i = 0, because the loop is terminating. But because i = 0, 
r - b! =r - b? = r.Hencer = a", and the method really does compute the nth power of a. 

This technique is quite useful, because it can explain an algorithm that is not at all obvi- 
ous. The condition (I) is called a loop invariant because it is true when the loop is entered, at 
the top of each pass, and when the loop is exited. If a loop invariant is chosen skillfully, you 
may be able to deduce correctness of a computation. See [3] for another nice example. 


RANDOM FACT 6.2 
Correctness Proofs 


In Advanced Topic 6.5 we introduced the technique of loop invariants. If you skipped that 
topic, have a glance at it now. That technique can be used to rigorously prove that a loop 
computes exactly the value that it is supposed to compute. Such a proof is far more valuable 
than any testing. No matter how many test cases you try, you always worry whether another 
case that you haven’t tried yet might show a bug. A proof settles the correctness for all possi- 
ble inputs. 

For some time, programmers were very hopeful that proof techniques such as loop 
invariants would greatly reduce the need of testing. You would prove that each simple 
method is correct, and then put the proven components together and prove that they work 
together as they should. Once it is proved that main works correctly, no testing is required. 
Some researchers were so excited about these techniques that they tried to omit the pro- 
gramming step altogether. The designer would write down the program requirements, using 
the notation of formal logic. An automatic prover would prove that such a program could be 
written and generate the program as part of its proof. 

Unfortunately, in practice these methods never worked very well. The logical notation to 
describe program behavior is complex. Even simple scenarios require many formulas. It is 
easy enough to express the idea that a method is supposed to compute a”, but the logical for- 
mulas describing all methods in a program that controls an airplane, for instance, would fill 
many pages. These formulas are created by humans, and humans make errors when they deal 
with difficult and tedious tasks. Experiments showed that instead of buggy programs, pro- 
grammers wrote buggy logic specifications and buggy program proofs. 

Van der Linden [2, p. 287], gives some examples of complicated proofs that are much 
harder to verify than the programs they are trying to prove. 

Program proof techniques are valuable for proving the correctness of individual methods 
that make computations in nonobvious ways. At this time, though, there is no hope to prove 
any but the most trivial programs correct in such a way that the specification and the proof 
can be trusted more than the program. There is hope that correctness proofs will become 
more applicable to real-life programming situations in the future. However, engineering and 
management are at least as important as mathematics and logic for the successful completion 
of large software projects. 
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As you have undoubtedly realized by now, computer programs rarely run perfectly 
the first time. At times, it can be quite frustrating to find the bugs. Of course, you 
can insert print commands, run the program, and try to analyze the printout. If the 
printout does not clearly point to the problem, you may need to add and remove 
print commands and run the program again. That can be a time-consuming process. 

wg Modern development environments contain special programs, 
called debuggers, that help you locate bugs by letting you follow the 
execution of a program. You can stop and restart your program and 
see the contents of variables whenever your program is temporarily 
stopped. At each stop, you have the choice of what variables to 

inspect and how many program steps to run until the next stop. 

Some people feel that debuggers are just a tool to make programmers lazy. 
Admittedly some people write sloppy programs and then fix them up with a 
debugger, but the majority of programmers make an honest effort to write the best 
program they can before trying to run it through a debugger. These programmers 
realize that a debugger, while more convenient than print commands, is not cost- 
free. It does take time to set up and carry out an effective debugging session. 

In actual practice, you cannot avoid using a debugger. The larger your programs 
get, the harder it is to debug them simply by inserting print commands. You will 
find that the time investment to learn about a debugger is amply repaid in your pro- 
gramming career. 

Like compilers, debuggers vary widely from one system to another. On some 
systems they are quite primitive and require you to memorize a small set of arcane 
commands; on others they have an intuitive window interface. The screen shots in 
this chapter show the debugger in the Eclipse development environment, down- 
loadable for free from the Eclipse Foundation web site [4]. Other integrated envi- 
ronments, such as Blue], also include debuggers. A free standalone debugger called 
JSwat is available from the JSwat Graphical Java Debugger web page [5]. 

You will have to find out how to prepare a program for debugging and how to 
start a debugger on your system. If you use an integrated development environ- 
ment, which contains an editor, compiler, and debugger, this step is usually very 
easy. You just build the program in the usual way and pick a menu command to 
start debugging. On some systems, you must manually build a debug version of 
yout pen and invoke the debugger. 

, Once you have started the debugger, you can go a long way with 
just three debugging commands: “set breakpoint”, “single step”, and 
“inspect variable”. The names and keystrokes or mouse clicks for 
these commands differ widely between debuggers, but all debuggers 
support these basic commands. You can find out how, either from 
the documentation or a lab manual, or by asking someone who has 
used the debugger before. 


6.6 Using a Debugger TESTING TRACK 265 


When you start the debugger, it runs at full speed until it reaches a 
breakpoint. Then execution stops, and the breakpoint that causes the 
stop is displayed (see Figure 5). You can now inspect variables and 
step through the program a line at a time, or continue running the 
program at full speed until it reaches the next breakpoint. When the 
program terminates, the debugger stops as well. 

Breakpoints stay active until you remove them, so you should periodically clear 
the breakpoints that you no longer need. 

Once the program has stopped, you can look at the current values of variables. 
Again, the method for selecting the variables differs among debuggers. Some 
debuggers always show you a window with the current local variables. On other 
debuggers you issue a command such as “inspect variable” and type in or click on 
the variable. The debugger then displays the contents of the variable. If all variables 


‘@ Debug - SyllableCounter.java -Eclipse SDK © 
File ‘Edit Source | ‘Refactor rs sae Search Project Run oe Help 
itt 3 2 8 tw. (|) @ iS bs te ee 


Debug x i Bw Variables 3% ~ _ Breakpoints. it ae 


vy & SyllableCounter [Java Application] i : ‘String{O] (id= | 
v @ SyllableCounter at localhost:50100 : ei Scanner (id=) | 
: "hello" 


Word lid= 21) 


String input; 
do 
{ 

input = in.next{); 

Word w = new Word{input) ; . 

Lla ; = w.countSyllables(); 
BUSTER. out. Par orn eyes in “ + input + ": " 
+ syllables) ; 


} 
while (!input .endswith(".")); 


Siabiecoutarl foe Application] thome/apps/idk1. 6. 0- -b104/binyjava (Nov 10, 2006 - 


aed a sentence ending ina period. 
Llo Well Li [eae oA. 


Figure 5 Stopping at a Breakpoint 
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contain what you expected, you can run the program until the next point where you 
want to stop. 

When inspecting objects, you often need to give a command to “open up” the 
object, for example by clicking on a tree node. Once the object is opened up, you 
see its instance variables (see Figure 6). 

| Running to a breakpoint gets you there speedily, but you don’t 
know how the program got there. You can also step through the 
program a line at a time. Then you know how the program flows, but 
it can take a long time to step through it. The single-step command 
executes the current line and stops at the next program line. Most 
debuggers have two single-step commands, one called step into, which steps inside 
method calls, and one called step over, which skips over method calls. 

For example, suppose the current line is 

String input = in.nextQ); 

Word w = new Word(input) ; 


int syllables = w.countSyllablesQ; 
System.out.printInC'Syllables in " 


+ Input + + syllables); 


When you step over method calls, you get to the next line: 


String input = in.nextQ); 
Word w = new Word(input) ; 
int syllables = w.countSyllablesQ; 
System.out.printInC"Syllables in " 


+ Input + + syllables); 


However, if you step into method calls, you enter the first line of the 
countSyllables method. 


public int countSy1lables() 


ant count = 0; 
int end = text.lengthQ - 1; 
Co sariables 38 Breakpoints. 
| Name Value 
| Sp SecA oT RSSHAGR dsc Lab sc OP niobate atte AS a at IN da Saati 
| © args String[0] {id= 
D @ in Scanner (id=: 
| > © input "Hello" 
| @ count 5 
| g@ hash 0 
| a offset ) ~ 
| v a value char[5] (id=2 | 
| & [0] H . 
( 
H 
Figure 6 | 


inspecting Variables (ee 
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You should step into a method to check whether it carries out its job correctly. You 
should step over a method if you know it works correctly. 

Finally, when the program has finished running, the debug session is also fin- 
ished. To run the program again, you may be able to reset the debugger, or you may 
need to exit the debugging program and start over. Details depend on the particular 
debugger. 


SELF CHECK 


11. In the debugger, you are reaching a call to System. out.printin. Should you step 
into the method or step over it? 


12. In the debugger, you are reaching the beginning of a method with a couple of 
loops inside. You want to find out the return value that is computed at the end 
of the method. Should you set a breakpoint, or should you step through the 
method? 


To have a realistic example for running a debugger, we will study a word class whose 
primary purpose is to count the number of syllables in a word. The class uses this 
rule for counting syllables: 

Each group of adjacent vowels (a, e, 1, 0, u, y) counts as one syllable (for example, 
the “ea” in “peach” contributes one syllable, but the “e... 0” in “yellow” counts as 


¢ ‘e BD | 


two syllables). However, an athe ond. oF aqrond voesye count aca syllable. 
Each word has at least one syllable, even if the previous rules give a count of 0. 

Also, when you construct a word from a string, any characters at the beginning 
or end of the string that aren’t letters are stripped off. That is useful when you read 
the input using the next method of the Scanner class. Input strings can still contain 
quotation marks and punctuation marks, and we don’t want them as part of the 
word. 

Here is the source code. There are a couple of bugs in this class. 


ch06/debugger/Word.java 
1 public class Word 


2 { 

3 | ha oi 

4 Constructs a word by removing leading and trailing non- 
5 letter characters, such as punctuation marks. 

6 @param s the input string 

i 7] 

8 public Word(String s) 
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9 { 

10 int i = 0; 

11 while (i < s.lengthQ) && !Character.isLetter(s.charAt(1))) 
12 i++; 

13 int j = s.length(Q) - 1; 

14 while (j > 1 && !Character.isLetter(s.charAt(j))) 
15 j--3 

16 text = s.substring(i, j); 

17 } 

18 

19 [** 

20 Returns the text of the word, after removal of the 

21 leading and trailing nonletter characters. 

22 @return the text of the word 

23 * 

24 public String getTextQ 

25 { 

26 return text; 

27 } 

28 

29 Viegas 

30 Counts the syllables in the word. 

31 @return the syllable count 

32 * / 

33 public int countSy1lables() 

34 { 

35 int count = 0; 

36 int end = text.lengthQ - 1; 

37 if (end < 0) return 0; // The empty string has no syllables 
38 

39 // Aneatthe end of the word doesn’t count as a vowel 
40 char ch = Character. toLowerCase(text.charAt(Cend) ) ; 
41 if (ch == 'e') end--; 

42 

43 boolean insideVowelGroup = false; 

44 for Cint i = 0; i <= end; i++) 

45 { 

46 ch = Character.toLowerCase(text.charAt(1)); 
47 if C'aeiouy".indexOf(ch) >= 0) 

48 af 

49 // chis a vowel 

50 if C!insideVowelGroup) 

al { 

52 // Start of new vowel group 

53 count++; 

54 insideVowelGroup = true; 

55 } 

56 , 

57 } 

58 

59 // Every word has at least one syllable 

60 if Ccount == 0) 

61 count = 1; 
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63 return count; 

64 } 

65 

66 private String text; 
67 } 


Here is a simple test class. Type in a sentence, and the syllable counts of all words 
are displayed. 


ch06/debugger/SyllableCounter.java 
1 import java.util.Scanner; 


/* ¥* 


This program counts the syllables of all words in a sentence. 


3 

4 

5 

6 public class SyllableCounter 
7 

8 

9 


{ 

public static void main(String[] args) 

{ 
10 Scanner in = new Scanner(System.in); 
11 
12 System.out.printInC’Enter a sentence ending in a period."); 
13 
14 String input; 
15 do 
16 { 
17 input = in.nextQ; 
18 Word w = new Word(input); 
19 int syllables = w.countSyllables(); 
20 System.out.printInC'Syllables in " + input +": " 
21 + syllables); 
22 i; 
23 while (!input.endswith(".")); 
24 } 
25} 
Supply this input: 


hello yellow peach. 
Then the output is 


Syllables in hello: 1 
Syllables in yellow: 1 
Syllables in peach.: 1 


That is not very promising. 

First, set a breakpoint in the first line of the countSyllables method of the Word 
class, in line 33 of Word. java. Then start the program. The program will prompt you 
for the input. The program will stop at the breakpoint you just set. 
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pubLic int countSylLables(} 
t 


int count = 8; 
int end = text.length{) - L; 
if {end < 8} return 8; // The emoty string has no syllables 


kee need cgi Lanai =afraattoeraet oat gan 


¢ Ff & any cae ie pr oe eee - EP ae ais ee Tach ae at oe mo bey ee goes 7% (tS ee 
f/f S&S @ at the end of the word doesn’t count as @ vowel 


= Cha ol owerCased text charaAt (end) }; 


+ osfeetetteatenter ta emcesintincaianey 


Figure 7 Debugging the countSyllables Method 


First, the countSy1lables method checks the last character of the word to see if it 
is a letter 'e'. Let’s just verify that this works correctly. Run the program to line 41 
(see Figure 7). 

Now inspect the variable ch. This particular debugger has a handy display of all 
current local and instance variables—see Figure 8. If yours doesn’t, you may need 
to inspect ch manually. You can see that ch contains the value '1'. That is strange. 
Look at the source code. The end variable was set to text. length() - 1, the last 
position in the text string, and ch is the character at that position. 

Looking further, you will find that end is set to 3, not 4, as you would expect. 
And text contains the string "hel1", not "hello". Thus, it is no wonder that count- 
Syllables returns the answer 1. We'll need to look elsewhere for the culprit. Appar- 
ently, the Word constructor contains an error. 

Unfortunately, a debugger cannot go back in time. Thus, you must stop the 
debugger, set a breakpoint in the word constructor, and restart the debugger. Supply 
the input once again. The debugger will stop at the beginning of the Word construc- 
tor. The constructor sets two variables i and j, skipping past any nonletters at the 
beginning and the end of the input string. Set a breakpoint past the end of the sec- 
ond loop (see Figure 9) so that you can inspect the values of i and j. 


Lap Sat agp 8 aha aah AN aa A Noun peas gece agn Sangean Sanayi Lag hg a hat aaah eanensa Naas MASA A 


‘word Gid=11) 
"bell 


Figure 8 The Current Values of the Local and Instance Variables 
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public word(String s) 
{ 


int i = 0; 

while (i < s.length{) && !Character.isLetter(s.charAt(i))) 
i++; 

int j = s.length() - 1; 

while {j > i && !Character.isLetter(s.charAt(j))) 


Sj ; 
ay ; 
i} el point 
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Figure 9 Debugging the Word Constructor 


At this point, inspecting i and j shows that i is 0 and j is 4. That makes sense— 
there were no punctuation marks to skip. So why is text being set to "hel1"? Recall 
that the substring method counts positions up to, but not including, the second 
parameter. Thus, the correct call should be 


text = s.substring(i, j + 1); 


This is a very typical off-by-one error. 
Fix this error, recompile the program, and try the three test cases again. You will 
now get the output 


Syllables in hello: 1 
Syllables in yellow: 1 
Syllables in peach.: 1 


As you can see, there still is a problem. Erase all breakpoints and set a breakpoint in 
the countSyllables method. Start the debugger and supply the input "hello." 
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When the debugger stops at the breakpoint, start single stepping through the lines 
of the method. Here is the code of the loop that counts the syllables: 


boolean insideVowelGroup = false; 
for Cint 1 = 0; 1 <= end; i++) 


{ 
ch = Character.toLowerCase(text.charAt(i)); 
if C'aeiouy".indexOf(ch) >= 0) 
if 
// chisa vowel 
if C!insideVowelGroup) 
{ 
// Start of new vowel group 
count++; 
insideVowelGroup = true; 
} 
, 
; 


In the first iteration through the loop, the debugger skips the if statement. That 
makes sense, because the first letter, 'h', isn’t a vowel. In the second iteration, the 
debugger enters the if statement, as it should, because the second letter, 'e', is a 
vowel. The insideVowelGroup variable is set to true, and the vowel counter is incre- 
mented. In the third iteration, the if statement is again skipped, because the letter 
'1' is not a vowel. But in the fifth iteration, something weird happens. The letter 
'o' is a vowel, and the if statement is entered. But the second if statement is 
skipped, and count is not incremented again. 

Why? The insideVowelGroup variable is still true, even though the first vowel 
group was finished when the consonant '1' was encountered. Reading a consonant 
should set insideVowelGroup back to false. This is a more subtle logic error, but not 
an uncommon one when designing a loop that keeps track of the processing state. 


To fix it, stop the debugger and add the following clause: 


if C"aeiouy".indexOf(ch) >= 0) 
{ 


} 


else insideVowelGroup = false; 
Now recompile and run the test once again. The output is: 


Syllables in hello: 2 

Syllables in yellow: 2 

Syllables in peach.: 1 
Is the program now free from bugs? That is not a question the 
debugger can answer. Remember: Testing can show only the pres- 
ence of bugs, not their absence. 


SELF CHECK 


13. What caused the first error that was found in this debugging session? 
14. What caused the second error? How was it detected? 
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How To 6.2 


Debugging 


Now you know about the mechanics of debugging, but all that knowledge may still leave 
you helpless when you fire up a debugger to look at a sick program. There are a number of 
strategies that you can use to recognize bugs and their causes. 


Step 1. Reproduce the error. 


As you test your program, you notice that your program sometimes does something wrong. 
It gives the wrong output, it seems to print something completely random, it goes in an infi- 
nite loop, or it crashes. Find out exactly how to reproduce that behavior. What numbers did 
you enter? Where did you click with the mouse? 

Run the program again; type in exactly the same answers, and click with the mouse on the 
same spots (or as close as you can get). Does the program exhibit the same behavior? If so, 
then it makes sense to fire up a debugger to study this particular problem. Debuggers are 
good for analyzing particular failures. They aren’t terribly useful for studying a program in 
general. 


Step 2. Simplify the error. 


Before you fire up a debugger, it makes sense to spend a few minutes trying to come up with 
a simpler input that also produces an error. Can you use shorter words or simpler numbers 
and still have the program misbehave? If so, use those values during your debugging session. 


Step 3 Divide and conquer. 


Now that you have a particular failure, you want to get as 
close to the failure as possible. The key point of debugging is 
to locate the code that produces the failure. Just as with real 
insect pests, finding the bug can be hard, but once you find it, 
squashing it is usually the easy part. Suppose your program 
dies with a division by 0. Because there are many division 
operations in a typical program, it is often not feasible to set 
breakpoints to all of them. Instead, use a technique of divide and conquer. Step over the 
methods in main, but don’t step inside them. Eventually, the failure will happen again. Now 
you know which method contains the bug: It is the last method that was called from main 
before the program died. Restart the debugger and go back to that line in main, then step 
inside that method. Repeat the process. 

Eventually, you will have pinpointed the line that contains the bad division. Maybe it is 
completely obvious from the code why the denominator is not correct. If not, you need to 
find the location where it is computed. Unfortunately, you can’t go back in the debugger. 
You need to restart the program and move to the point where the denominator computation 


happens. 


Step 4. Know what your program should do. 


A debugger shows you what the program does. You must 
know what the program should do, or you will not be able to 
find bugs. Before you trace through a loop, ask yourself how 
many iterations you expect the program to make. Before you 
inspect a variable, ask yourself what you expect to see. If you 
have no clue, set aside some time and think first. Have a 
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calculator handy to make independent computations. When you know what the value 
should be, inspect the variable. This is the moment of truth. If the program is still on the 
right track, then that value is what you expected, and you must look further for the bug. If 
the value is different, you may be on to something. Double-check your computation. If you 
are sure your value is correct, find out why your program comes up with a different value. 

In many cases, program bugs are the result of simple errors such as loop termination con- 
ditions that are off by one. Quite often, however, programs make computational errors. 
Maybe they are supposed to add two numbers, but by accident the code was written to sub- 
tract them. Unlike your calculus instructor, programs don’t make a special effort to ensure 
that everything is a simple integer (and neither do real-world problems). You will need to 
make some calculations with large integers or nasty floating-point numbers. Sometimes 
these calculations can be avoided if you just ask yourself, “Should this quantity be positive? 
Should it be larger than that value?” Then inspect variables to verify those theories. 


Step 5 Look at all details. 


When you debug a program, you often have a theory about what the problem is. Neverthe- 
less, keep an open mind and look around at all details. What strange messages are displayed? 
Why does the program take another unexpected action? These details count. When you run 
a debugging session, you really are a detective who needs to look at every clue available. 

If you notice another failure on the way to the problem that you are about to pin down, 
don’t just say, “I’ll come back to it later”. That very failure may be the original cause for 
your current problem. It is better to make a note of the current problem, fix what you just 
found, and then return to the original mission. 


Step 6 Make sure you understand each bug before you fix it. 


Once you find that a loop makes too many iterations, it is very tempting to apply a “Band- 
Aid” solution and subtract 1 from a variable so that the particular problem doesn’t appear 
again. Such a quick fix has an overwhelming probability of creating trouble elsewhere. You 
really need to have a thorough understanding of how the program should be written before 
you apply a fix. 

It does occasionally happen that you find bug after bug and apply fix after fix, and the 
problem just moves around. That usually is a symptom of a larger problem with the program 
logic. There is little you can do with the debugger. You must rethink the program design and 
reorganize It. 


RANDOM FACT 6.3 


The First Bug 


According to legend, the first bug was one found in 1947 in the Mark II, a huge electro- 
mechanical computer at Harvard University. It really was caused by a bug—a moth was 
trapped in a relay switch. Actually, from the note that the operator left in the log book next 
to the moth (see The First Bug figure), it appears as if the term “bug” had already been in 
active use at the time. 

The pioneering computer scientist Maurice Wilkes wrote: “Somehow, at the Moore 
School and afterwards, one had always assumed there would be no particular difficulty in 
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The First Bug 


getting programs right. I can remember the exact instant in time at which it dawned on me 
that a great part of my future life would be spent finding mistakes in my own programs.” 


CHAPTER SUMMARY © 


1. A while statement executes a block of code repeatedly. A condition controls 
how often the loop is executed. 


2. An off-by-one error is a common error when programming loops. Think 
through simple test cases to avoid this type of error. 


3. You use a for loop when a variable runs from a starting to an ending value with 
a constant increment or decrement. 


4. Loops can be nested. A typical example of nested loops is printing a table with 
rows and columns. 


5. Sometimes, the termination condition of a loop can only be evaluated in the 
middle of a loop. You can introduce a Boolean variable to control such a loop. 


6. Make a choice between symmetric and asymmetric loop bounds. 
7. Count the number of iterations to check that your for loop is correct. 


8. In a simulation, you repeatedly generate random numbers and use them to 
simulate an activity. 


9. A debugger is a program that you can use to execute another program and ana- 
lyze its run-time behavior. 


10. You can make effective use of a debugger by mastering just three concepts: 
breakpoints, single-stepping, and inspecting variables. 


11. When a debugger executes a program, the execution is suspended whenever a 
breakpoint is reached. 
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12. The single-step command executes the program one line at a time. 


13. A debugger can be used only to analyze the presence of bugs, not to show that a 
program is bug-free. 


14. Use the divide-and-conquer technique to locate the point of failure of a 
program. 


15. During debugging, compare the actual contents of variables against the values 
you know they should have. 


FURTHER READING 
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2. Peter van der Linden, Expert C Programming, Prentice-Hall, 1994. 


3. Jon Bentley, Programming Pearls, Chapter 4, “Writing Correct Programs”, Addison- 
Wesley, 1986. 


4. http://eclipse.org The Eclipse Foundation web site. 
5. http://www.bluemarsh.com/java/jswat The JSwat Graphical Java Debugger web page. 


6. Kai Lai Chung, Elementary Probability Theory with Stochastic Processes, Undergraduate 
Texts in Mathematics, Springer-Verlag, 1974. 
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CLASSES, OBJECTS, AND METHODS 


java.util.Random 
nextDouble 
nextint 


kx Exercise R6.1. Which loop statements does Java support? Give simple rules when to 
use each loop type. 


wx Exercise R6.2. What does the following code print? 


for Cint i = 0; i < 10; 1++) 
{ 
for (int j = 0; j < 10; j++) 
System.out.print(i * j % 10); 
System.out.printinQ); 
} 
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wk Exercise R6.3. How often do the following loops execute? Assume that i is an inte- 
ger variable that is not changed in the loop body. 


a. for Gi = 1; i <= 10; i++) 

. for Gi = 0; 1 < 10; i++). 

for Ci = 10; i> 0; i--). 

for (i = -10; i <= 10; i++) . 

for Ci = 10; i >= 0; i++) . 

for Gi = -10; i <= 10; i = i+ 2). 
g. for Gi = -10; i <= 10; i = i + 3). 


> oan ce 


* Exercise R6.4. Rewrite the following for loop into a while loop. 


int s = 0; 
for Cint i = 1; i <= 10; i++) s =s +i; 


** Exercise R6.5. Rewrite the following do loop into a while loop. 


; 
while (s > 0.01); 


* Exercise R6.6. What is an infinite loop? On your computer, how can you terminate a 
program that executes an infinite loop? 


kx Exercise R6.7. Give three strategies to implement the following “loop and a half”: 


loop 
{ 
Read name of bridge 
If not OK, exit loop 
Read length of bridge in feet 
If not OK, exit loop 


Convert length to meters 
Print bridge data 
} 


Use a Boolean variable, a break statement, and a method with multiple return state- 
ments. Which of these three approaches do you find clearest? 


* Exercise R6.8. Implement a loop that prompts a user to enter a number between 1 
and 10, giving three tries to get it right. 


* Exercise R6.9. Sometimes students write programs with instructions such as “Enter 
data, 0 to quit” and that exit the data entry loop when the user enters the number 0. 
Explain why that is usually a poor idea. 
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Exercise R6.10. How would you use a random number generator to simulate the 
drawing of a playing card? 
Exercise R6.11. What is an “off-by-one error”? Give an example from your own pro- 


gramming experience. 


Exercise R6.12. Give an example of a for loop in which symmetric bounds are more 
natural. Give an example of a for loop in which asymmetric bounds are more 
natural. 


Exercise R6.13. What are nested loops? Give an example where a nested loop 1s typi- 
cally used. 


Exercise R6.14. Explain the differences between these debugger operations: 
e Stepping into a method 
e Stepping over a method 


Exercise R6.15. Explain in detail how to inspect the string stored in a String object in 
your debugger. | 


Exercise R6.16. Explain in detail how to inspect the information stored in a Rectangle 
object in your debugger. 


Exercise R6.17. Explain in detail how to use your debugger to inspect the balance 
stored in a BankAccount object. 


Exercise R6.18. Explain the divide-and-conquer strategy to get close to a bug ina 
debugger. 


Additional review exercises are available in WileyPLUS. 


PROGRAMMING EXERCISES 


Exercise P6.1. Currency conversion. Write a program CurrencyConverter that asks the 
user to enter today’s exchange rate between U.S. dollars and the euro. Then the pro- 
gram reads U.S. dollar values and converts each to euro values. Stop when the user 

enters Q. 


Exercise P6.2. Projectile flight. Suppose a cannonball is propelled vertically into the 
air with a starting velocity vp. Any calculus book will tell us that the position of 
the ball after ¢ seconds is s(t) = -0.5- gt? + Vp -t, where g=9.81 m/sec” is the 
gravitational force of the earth. No calculus book ever mentions why someone 
would want to carry out such an obviously dangerous experiment, so we will do it 
in the safety of the computer. 


In fact, we will confirm the theorem from calculus by a simulation. In our simula- 
tion, we will consider how the ball moves in very short time intervals At. In a short 
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time interval the velocity v is nearly constant, and we can compute the distance the 
ball moves as As = v- At. In our program, we will simply set 


double deltaT = 0.01; 
and update the position by 
S=S + v * deltaT; 


The velocity changes constantly —in fact, it is reduced by the gravitational force of 
the earth. In a short time interval, v decreases by g- At, and we must keep the 
velocity updated as 


v=v- g * deltatT; 
In the next iteration the new velocity is used to update the distance. 


Now run the simulation until the cannonball falls back to the earth. Get the initial 
velocity as an input (100 m/sec is a good value). Update the position and velocity 
100 times per second, but only print out the position every full second. Also print 
out the values from the exact formula s(t) = —0.5- g-t* + Uy ‘t for comparison. Use 
a class Cannonba11. 


What is the benefit of this kind of simulation when an exact formula is available? 
Well, the formula from the calculus book is not exact. Actually, the gravitational 
force diminishes the farther the cannonball is away from the surface of the earth. 
This complicates the algebra sufficiently that it is not possible to give an exact for- 
mula for the actual motion, but the computer simulation can simply be extended to 
apply a variable gravitational force. For cannonballs, the calculus-book formula is 
actually good enough, but computers are necessary to compute accurate trajectories 
for higher-flying objects such as ballistic missiles. 


w&* Exercise P6.3. Write a program that prints the powers of ten 


£0 

10.0 
100.0 
1000.0 
10000 .0 
100000 .0 
1000000.0 
1.<0E7 
1.0E8 
£.OE9 
1.0E10 
1.0E11 


Implement a class 


public class PowerGenerator 
{ 
/* ¥ 
Constructs a power generator. 
@param aFactor the number that will be multiplied by itself 
% / 


public PowerGenerator(double aFactor) { ... } 
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[** 
Computes the next power. 
* / 
public double nextPower() { .. . } 


} 


Then supply a test class PowerGeneratorRunner that calls System.out.printIn( 
myGenerator.nextPower()) twelve times. 


Exercise P6.4. The Fibonacci sequence is defined by the following rule. The first two 
values in the sequence are 1 and 1. Every subsequent value is the sum of the two 
values preceding it. For example, the third value is 1 + 1 = 2, the fourth value is 

1 +2 =3,and the fifth is 2+ 3 =5. If f, denotes the mth value in the Fibonacci 
sequence, then 


f=! 
f, =1 
f,=fiitf-2 ifm > 2 


Write a program that prompts the user for 7 and prints the first 7 values in the 
Fibonacci sequence. Use a class FibonacciGenerator with a method nextNumber. 


Hint: There is no need to store all values for f,,. You only need the last two values to 
compute the next one in the series: 


foldlL = ds 
Ffold2 13 
fnew = foldl + fold2; 


After that, discard fold2, which is no longer needed, and set fold2 to fold1 and 
foldl to fnew. 


Your generator class will be tested with this runner program: 


public class FibonacciRunner 


{ 


public static void main(String[] args) 


{ 


Scanner in = new Scanner(System.1n); 


System.out.printInC"Enter n:"); 
int n = in.nextIntQ; 


FibonacciGenerator fg = new FibonacciGenerator() ; 


for Cint i = 1; i <= n; i++) 
System.out.printIn(fg.nextNumber() ) ; 


} 


Exercise P6.5. Mean and standard deviation. Write a program that reads a set of 
floating-point data values from the input. When the user indicates the end of input, 


od 


xk 
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print out the count of the values, the average, and the standard deviation. The aver- 
age of a data set x1,...,X, 1s 


n 


where > x; = x, +--+ x, 1s the sum of the input values. The standard deviation is 


However, that formula is not suitable for our task. By the time you have computed 
the mean, the individual x; are long gone. Until you know how to save these values, 
use the numerically less stable formula 


You can compute this quantity by keeping track of the count, the sum, and the sum 
of squares in the DataSet class as you process the input values. 


Exercise P6.6. Factoring of integers. Write a program that asks the user for an integer 
and then prints out all its factors in increasing order. For example, when the user 
enters 150, the program should print 


2 
5) 
5 
5 


Use a class FactorGenerator with a constructor FactorGenerator(int numberToFac- 
tor) and methods nextFactor and hasMoreFactors. Supply a class FactorPrinter 
whose main method reads a user input, constructs a FactorGenerator object, and 
prints the factors. 


Exercise P6.7. Prime numbers. Write a program that prompts the user for an integer 
and then prints out all prime numbers up to that integer. For example, when the 
user enters 20, the program should print 


2 
3 
5 
rg 
11 
i3 
17 
19 


Recall that a number is a prime number if it is not divisible by any number except 1 
and itself. 


Supply a class PrimeGenerator with a method nextPrime. 
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Exercise P6.8. The Heron method is a method for computing square roots that was 
known to the ancient Greeks. If x is a guess for the value Va, then the average of x 
and a/x is a better guess. 


aix ne x 


ee 


Midpoint 


Implement a class RootApproximator that starts with an initial guess of 1 and whose 
nextGuess method produces a sequence of increasingly better guesses. Supply a 
method hasMoreGuesses that returns false if two successive guesses are sufficiently 
close to each other (that is, they differ by no more than a small value e). Then test 
your class like this: 

RootApproximator approx = new RootApproximator(a, EPSILON) ; 


while (approx.hasMoreGuesses() ) 
System. out. print InCapprox.nextGuess()) ; 


Exercise P6.9. The best known iterative method for computing the roots of a func- 
tion f (that is, the x-values for which f(x) is 0) is Newton—Raphson approximation. 
To find the zero of a function whose derivative is also known, compute 


Knew = Xolg —F (xs1a)/ i: cere 


For this exercise, write a program to compute mth roots of floating-point 
numbers. Prompt the user for a and n, then obtain Va by computing a zero of 
the function f(x) = x” — a. Follow the approach of Exercise P6.8. 


Exercise P6.10. The value of e~ can be computed as the power series 


where n!=1-2-3-...-n. 

Write a program that computes e* using this formula. Of course, you can’t compute 
an infinite sum. Just keep adding values until an individual summand (term) is less 
than a certain threshold. At each step, you need to compute the new term and add it 
to the total. Update these terms as follows: 


term = term * x / n; 


Follow the approach of the preceding two exercises, by implementing a class 
ExpApproximator. Its first guess should be 1. 


Exercise P6.11. Write a program RandomDataAnalyzer that generates 100 random 
numbers between 0 and 1000 and adds them to a DataSet. Print out the average and 
the maximum. 


Exercise P6.12. Program the following simulation: Darts are thrown at random 
points onto the square with corners (1,1) and (—1,-1). If the dart lands inside the 
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unit circle (that is, the circle with center (0,0) and radius 1), it is a hit. Otherwise it is 
a miss. Run this simulation and use it to determine an approximate value for z. 
Extra credit if you explain why this is a better method for estimating z than the 
Buffon needle program. 


Exercise P6.13. Random walk. Simulate the wandering of an intoxicated person in a 
square street grid. Draw a grid of 20 streets horizontally and 20 streets vertically. 
Represent the simulated drunkard by a dot, placed in the middle of the grid to start. 
For 100 times, have the simulated drunkard randomly pick a direction (east, west, 
north, south), move one block in the chosen direction, and draw the dot. (One 
might expect that on average the person might not get anywhere because the moves 
to different directions cancel one another out in the long run, but in fact it can be 
shown with probability 1 that the person eventually moves outside any finite 
region. See, for example, [6, Chapter 8] for more details.) Use classes for the grid 


and the drunkard. 


Exercise P6.14. This exercise is a continuation of Exercise P6.2. Most cannonballs are 
not shot upright but at an angle. If the starting velocity has magnitude v and the 
starting angle is a, then the velocity is a vector with components v,, = v - cos(@), 
Vy = 0° sin(a@). In the x-direction the velocity does not change. In the y-direction 
the gravitational force takes its toll. Repeat the simulation from the previous exer- 
cise, but update the x and y components of the location and the velocity separately. 
In every iteration, plot the location of the cannonball on the graphics display as a 
tiny circle. Repeat until the cannonball has reached the earth again. 


This kind of problem is of historical interest. The first computers were designed to 
carry out just such ballistic calculations, taking into account the diminishing gravity 


for high-flying projectiles and wind speeds. 


Exercise P6.15. Write a graphical application that displays a checkerboard with 64 
squares, alternating white and black. 


Exercise P6.16. Write a graphical application that prompts a user to enter a number n 
and that draws n circles with random diameter and random location. The circles 
should be completely contained inside the window. 


Exercise P6.17. Write a graphical application that draws a spiral, such as the 
following: 
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Exercise P6.18. It is easy and fun to draw graphs of curves with the Java graphics 
library. Simply draw 100 line segments joining the points (x, f(x)) and (x + d, 

f(x + d)), where x ranges from Xin tO Xmax and d = (x4. — Xin )/ 100. 

Draw the curve f(x) = 0.00005x? — 0.03x* + 4x + 200, where x ranges from 0 to 
400 in this fashion. 


Exercise P6.19. Draw a picture of the “four-leaved rose” whose equation 1n polar 
coordinates is r = cos(20). Let 6 go from 0 to 27 in 100 steps. Each time, compute r 
and then compute the (x,y) coordinates from the polar coordinates by using the 
formula 

x = rcos8, y = rsin@ 


Additional programming exercises are available in WileyPLUS. 


PROGRAMMING PROJECTS —s_ 


Project 6.1. Flesch Readability Index. The following index [7] was invented by 
Flesch as a tool to gauge the legibility of a document without linguistic analysis. 


¢ Count all words in the file. A word is any sequence of characters delimited by 
white space, whether or not it is an actual English word. 

¢ Count all syllables in each word. To make this simple, use the following rules: 
Each group of adjacent vowels (a, e, i, 0, u, y) counts as one syllable (for exam- 
ple, the “ea” in “real” contributes one syllable, but the “e... a” in “regal” 


(¢ >) 


count as two syllables). However, an “e” at the end of a word doesn’t count as 
a syllable. Also, each word has at least one syllable, even if the previous rules 
give a count of 0. 


e Count all sentences. A sentence is ended by a period, colon, semicolon, ques- 
tion mark, or exclamation mark. 


e The index is computed by 


Index = 206.835 
— 84.6 x (Number of syllables/ Number of words) 


— 1.015 x (Number of words/Number of sentences) 


rounded to the nearest integer. 


The purpose of the index is to force authors to rewrite their text until the index is 
high enough. This is achieved by reducing the length of sentences and by removing 
long words. For example, the sentence 


The following index was invented by Flesch as a simple tool to estimate the legibility 
of a document without linguistic analysis. 


can be rewritten as 


Flesch invented an index to check whether a text is easy to read. To compute the 
index, you need not look at the meaning of the words. 
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Flesch’s book [7] contains delightful examples of translating government regula- 
tions into “plain English”. 

This index is a number, usually between 0 and 100, indicating how difficult the text 
is to read. Some example indices for random material from various publications are: 


Comics 95 
Consumer ads 2 ge 
Sports Illustrated 65 
Time S/ 

New York Times 39 
Auto insurance policy 10 
Internal Revenue Code —-6 


Translated into educational levels, the indices are: 


91-100 5th grader 
ee erader 
ie - 7th grader 

66-70 | 8th grader 
61-65 | 9th grader 
51-60 High school student 
31-50 College student 
0-30 College graduate 
Less thanO — Law school graduate 


Your program should read a text file in, compute the legibility index, and print out 
the equivalent educational level. Use classes Word and Document. 


kkk Project 6.2. The game of Nim. This is a well-known game with a number of variants. 
We will consider the following variant, which has an interesting winning strategy. 
Two players alternately take marbles from a pile. In each move, a player chooses how 
many marbles to take. The player must take at least one but at most half of the mar- 
bles. Then the other player takes a turn. The player who takes the last marble loses. 


Write a program in which the computer plays against a human opponent. Generate 
a random integer between 10 and 100 to denote the initial size of the pile. Generate 
a random integer between 0 and 1 to decide whether the computer or the human 
takes the first turn. Generate a random integer between 0 and 1 to decide whether 
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the computer plays smart or stupid. In stupid mode, the computer simply takes a 
random legal value (between 1 and 7/2) from the pile whenever it has a turn. In 
smart mode the computer takes off enough marbles to make the size of the pile a 
power of two minus 1—that is, 3, 7, 15, 31, or 63. That is always a legal move, 
except if the size of the pile is currently one less than a power of 2. In that case, the 
computer makes a random legal move. 


Note that the computer cannot be beaten in smart mode when it has the first move, 
unless the pile size happens to be 15, 31, or 63. Of course, a human player who has 
the first turn and knows the winning strategy can win against the computer. 


Be sure to use classes Pile, Player, and Game in your implementation. A player can 
be either stupid, smart, or human. (Human Player objects prompt for input.) 


ANSWERS TO SELF-CHECK QUESTIONS 


1. Never 
2. The waitForBalance method would never return due to an infinite loop. 
while (i <= n) 


double interest = balance * rate / 100; 
balance = balance + interest; 
1++5 
, 
11 times. 
Change the inner loop to for (int j = 1; j <= width; j++). 
20; 


Because we don’t know whether the next input is a number or the letter Q. 


on A 


No. If al/ input values are negative, the maximum is also negative. However, the 
maximum field is initialized with 0. With this simplification, the maximum would 
be falsely computed as 0. 


9. int n = generator.nextInt(2); // 0= heads, 1 = tails 


10. The program repeatedly calls Math. toRadians(angle). You could simply call 
Math. toRadians(180) to compute 7. 


11. You should step over it because you are not interested in debugging the 
internals of the printin method. 


12. You should set a breakpoint. Stepping through loops can be tedious. 


13. The programmer misunderstood the second parameter of the substring 
method —it is the index of the first character not to be included in the substring. 


14. The second error was caused by failing to reset insideVowelGroup to false at the 
end of a vowel group. It was detected by tracing through the loop and noticing 
that the loop didn’t enter the conditional statement that increments the vowel 
count. 
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Arrays and 
Array Lists 


© To become familiar with using arrays and array lists 


- * lo learn about wrapper classes, auto- -boxing, and the 
oo us ee for loop | : 


: udy common array algorithms ; 


To learn how t to use two- dimensional: arrays 


e@ To ‘understand when to choose array lists and arrays in 
your programs 


e To implement partially filled arrays 


T To understand oS concept of regression testing 


In order to process large quantities of data, you need to collect values in a data 
structure. The most commonly used data structures in Java are arrays and array 
lists. In this chapter, you will learn how to construct arrays and array lists, fill them 
with values, and access the stored values. We introduce the enhanced for loop, a 
convenient statement for processing all elements of a collection. You will see how to 
use the enhanced for loop, as well as ordinary loops, to implement common array 


algorithms. The chapter concludes with a technical section on copying array values. 
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In many programs, you need to manipulate collections of related values. It would 
be impractical to use a sequence of variables such as datal, data2, data3,..., and so 
on. The array construct provides a better way of storing a collection of values. 


An array is a sequence of values of the same type. For example, 
here is how you construct an array of 10 floating-point numbers: 


new double[10] 


The number of elements (here, 10) is called the length of the array. 

The new operator merely constructs the array. You will want to store a reference 
to the array in a variable so that you can access it later. 

The type of an array variable is the element type, tollowed by [1]. In this example, 
the type is double[], because the element type is double. Here is the declaration of 


an array variable: 


double[] data = new double[10]; 


That is, data is a reference to an array of floating-point numbers. It is initialized 
with an array of 10 numbers (see Figure 1). 
You can also form arrays of objects, for example 


BankAccount[] accounts 


new BankAccount[10] ; 
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data = 


Figure 1 An Array Reference and an Array 


When an array is first created, all values are initialized with 0 (for an array of num- 
bers such as int[] or double[]), false (for a boolean[] array), or nul] (for an array 
of object references). 

Each element in the array is specified by an integer index that is placed inside 
square brackets ([]). For example, the expression 


data[4] 


denotes the element of the data array with index 4. 


You can store a value at a location with an assignment statement, such as the 
following. 


data[2] = 29.95; 
Now the position with index 2 of data is filled with the value 29.95 
(see Figure 2). 


To read out the data value at index 2, simply use the expression 
data[2] as you would any variable of type double: 


System.out.printInC"The value of this data item is " 
+ data[2]); 


Figure 2 Storing a Value in an Array 
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If you look closely at Figure 2, you will notice that the index values start at 0. That 
1S, 

data[0] is the first element 

data[1] is the second element 

data[2] is the third element 


and so on. This convention can be a source of grief for the newcomer, so you should 
pay close attention to the index values. In particular, the /ast element in the array has 
an index one less than the array length. For example, data refers to an array with 
ener 10. The last element is data[9]. 

If you try to access an element that does not exist, then an excep- 
tion is thrown. For example, the statement 


data[10] = 29.95; // ERROR 


is a bounds error. 

To avoid bounds errors, you will want to know how many ele- 
ments are in an array. The length field returns the number of elements: 
data. length is the length of the data array. Note that there are no 
parentheses following length—it is an instance variable of the array 
object, not a method. However, you cannot assign a new value to this 
as a instance variable. In other words, length is a final public instance 
eae This ; is quite an anomaly. Normally, Java programmers use a method to 
inquire about the properties of an object. You just have to remember to omit the 
parentheses in this case. 

The following code ensures that you only access the array when the index vari- 
able i is within the legal bounds: 


if (0 <= i && i < data.length) data[i] = value; 


Arrays suffer from a significant limitation: thezr length 1s fixed. If you start out with 
an array of 10 elements and later decide that you need to add additional elements, 
then you need to make a new array and copy all values of the existing array into the 
new array. We will discuss this process in detail in Section 7.7. 


SYNTAX 7.1 Array Construction 


new typeName [length] 


Example: 
new double[10] 


Purpose: 


To construct an array with a given number of elements 
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SYNTAX 7.2 Array Element Access 


arrayReference [index] 


Example: 
data[2] 


Purpose: 


‘To access an element in an array 


SELF CHECK 


1. What elements does the data array contain after the following statements? 


double[] data = new double[10]; 
for Cint 71 = 0; 71 < data.length; i++) data[i] = 1 * 1; 

2. What do the following program segments print? Or, if there is an error, describe 
the error and specify whether it is detected at compile-time or at run-time. 


a. double[] a = new double[10]; 
System.out.printIn(a[0]) ; 


b. double[] b = new double[10]; 
System.out.printIn(b[10]); 


c. double[] c; 
System.out.printin¢cl0]); 


COMMON ERROR 7.1 
Bounds Errors 


The most common array error is attempting to access a nonexistent position. 


double[] data = new double[10]; 
data[10] = 29.95; 
// Error—only have elements with index values 0... 9 


When the program runs, an out-of-bounds index generates an exception and terminates the 
program. 

This is a great improvement over languages such as C and C++. With those languages 
there is no error message; instead, the program will quietly (or not so quietly) corrupt the 
memory location that is 10 elements away from the start of the array. Sometimes that corrup- 
tion goes unnoticed, but at other times, the program will act flaky or die a horrible death 
many instructions later. These are serious problems that make C and C++ programs difficult 
to debug. 
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COMMON ERROR 7.2 
Uninitialized Arrays 


A common error is to allocate an array reference, but not an actual array. 


double[] data; 
data[0O] = 29.95; // Error—data not initialized 


Array variables work exactly like object variables—they are only references to the actual 
array. To construct the actual array, you must use the new operator: 


double[] data = new double[10]; 


ADVANCED TOPIC 7.1 
Array Initialization 


You can initialize an array by allocating it and then filling each entry: 


intl] primes = new int[5]; 
primes[O] = 2; 


primes[1] = 3; 
primes[2] = 5; 
primes[3] = 7; 


primes[4] = 11; 
However, if you already know all the elements that you want to place in the array, there is an 


easier way. List all elements that you want to include in the array, enclosed in braces and sep- 
arated by commas: 


intl] primes = { 2, 3, 5, 7, 11 }; 
The Java compiler counts how many elements you want to place in the array, allocates an 
array of the correct size, and fills it with the elements that you specify. 


If you want to construct an array and pass it on to a method that expects an array param- 
eter, you can initialize an anonymous array as follows: 


new int[] { 2, 3, 5, 7, 11 } 


Arrays are a rather primitive construct. In this section, we introduce 
the ArrayList class that lets you collect objects, just like an array 
does. Array lists offer two significant conveniences: 
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e Array lists can grow and shrink as needed 


e The ArrayList class supplies methods for many common tasks, such as inserting 
and removing elements 


Let us define an array list of bank accounts and fill it with objects. (The BankAccount 
class has been enhanced from the version in Chapter 3. Each bank account has an 
account number.) 


ArrayList<BankAccount> accounts = new ArrayList<BankAccount>() ; 
accounts.add(new BankAccount(1001) ); 
accounts.add(new BankAccount(1015)); 
accounts.add(new BankAccount(1022)); 


The type ArrayList<BankAccount> denotes an array list of bank 
accounts. The angle brackets around the BankAccount type tell you that 
BankAccount is a type parameter. You can replace BankAccount with any 
other class and get a different array list type. For that reason, ArrayList 
is called a generic class. You will learn more about generic classes in 
Chapter 17. For now, simply use an ArrayList<T> whenever you want 
to collect objects of type T. However, keep in mind that you cannot use — 
types as type parameters—there 1 is nO ArrayList<int> or ArrayL1st<double>. 

When you construct an ArrayList object, it has size 0. You use the add method to 
add an object to the end of the array list. The size increases after each call to add. 
The size method yields the current size of the array list. 

To get objects out of the array list, use the get method, not the [ ] operator. As 
with arrays, index values start at 0. For example, accounts.get(2) retrieves the 
account with index 2, the third element in the array list: 


BankAccount anAccount = accounts.get(2) ; 


As with arrays, it is an error to access a nonexistent element. The most common 
bounds error is to use the following: 


int 1 = accounts.size(); 
anAccount = accounts.get(i); // Error 


The last valid index is accounts.size(Q) - 1. 
To set an array list element to a new value, use the set method. 


BankAccount anAccount = new BankAccount(1729) ; 
accounts.set(2, anAccount); 


This call sets position 2 of the accounts array list to anAccount, overwriting whatever 
value was there before. 

The set method can only overwrite existing values. It is different from the add 
method, which adds a new object to the end of the array list. 

You can also insert an object in the middle of an array list. The call 
accounts.add(i, a) adds the object a at position i and moves all elements by one 
position, from the current element at position i to the last element in the array list. 
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Before After 


Figure 3 Adding an Element in the Middle of an Array List 


Before After 


Figure 4 Removing an Element from the Middle of an Array List 


After each call to the add method, the size of the array list increases by 1 (see 
Figure 3). 

Conversely, the call accounts. remove(i) removes the element at position i, moves 
all elements after the removed element down by one position, and reduces the size 
of the array list by 1 (see Figure 4). 

The following program demonstrates the methods of the ArrayList class. Note 
that you import the generic class java.util.ArrayList, without the type parameter. 


ch07 /arraylist/ArrayListTester.java 
1 import java.util.ArrayList; 


ate ale 
ras 


This program tests the ArrayList class. 


public class ArrayListTester 


{ 


NOH vib wh 
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8 public static void main(String[] args) 

9 { 
10 ArrayList<BankAccount> accounts 
11 = new ArrayList<BankAccount>() ; 
12 accounts.add(new BankAccount(1001)); 
13 accounts.add(new BankAccount(1015)); 
14 accounts.add(new BankAccount(1729)); 
15 accounts.add(1, new BankAccount(1008)); 
16 accounts. remove(0); 
17 
18 System.out.printInC'Size: " + accounts.sizeQ); 
19 System.out.printInC("Expected: 3"); 
20 BankAccount first = accounts.get(0); 
Pa | System.out.printInC"First account number: " 
22 + first.getAccountNumberQ); 
23 System.out.printIn("Expected: 1008"); 
24 BankAccount last = accounts.get(accounts.size(Q) - 1); 
25 System.out.printInC"Last account number: " 
26 + last.getAccountNumber()); 
27 System.out.printInC"Expected: 1729"); 
28 } 
29 } 


ch07/arraylist/BankAccount.java 


l /** 
2 A bank account has a balance that can be changed by 
3 deposits and withdrawals. 
5 ~=public class BankAccount 
6 { 
7 /* ~ 
8 Constructs a bank account with a zero balance. 
9 @param anAccountNumber the account number for this account 
10 * / 
11 public BankAccount(int anAccountNumber) 
iZ { 
13 accountNumber = anAccountNumber; 
14 balance = 0; 
15 } 
16 
17 f* v 
18 Constructs a bank account with a given balance. 
19 @param anAccountNumber the account number for this account 
20 @param initialBalance the initial balance 
21 * / 
22 public BankAccount(int anAccountNumber, double initialBalance) 
23 { 
24 accountNumber = anAccountNumber; 
25 balance = initialBalance; 
26 } 
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28 i 
29 Gets the account number of this bank account. 
30 @return the account number 
31 * / 
32 public int getAccountNumber () 
33 { 
34 return accountNumber; 
35 J 
36 
37 Vian 
38 Deposits money into the bank account. 
39 @param amount the amount to deposit 
40 ‘ 
41 public void deposit(double amount) 
42 { 
43 double newBalance = balance + amount; 
44 balance = newBalance; 
45 } 
46 
47 
48 Withdraws money from the bank account. 
49 @param amount the amount to withdraw 
51 public void withdraw(double amount) 
52 { 
53 double newBalance = balance - amount; 
54 balance = newBalance; 
55 } 
56 
ny “a 
58 Gets the current balance of the bank account. 
59 @return the current balance 
60 * / 
61 public double getBalance() 
62 { 
63 return balance; 
64 } 
65 
66 private int accountNumber; 
67 private double balance; 
68 } 
Output 

Size: 3 

Expected: 3 


First account number: 1008 
Expected: 1008 

Last account number: 1729 
Expected: 1729 
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SELF CHECK 


3. How do you construct an array of 10 strings? An array list of strings? 
4. What is the content of names after the following statements? 


ArrayList<String> names = new ArrayList<String>Q() ; 
names.add("A"); 

names.add(O, "B"); 

names.add("C"); 

names.remove(1); 


COMMON ERROR 7.3 


Length and Size 
Unfortunately, the Java syntax for determining the number of elements in an array, an array 
list, and a string is not at all consistent. It is a common error to confuse these. You just have 
to remember the correct syntax for every data type. 

Data Type Number of Elements 

a. length 


_ a.sizeO 


“a. Tength() 


QUALITY TIP 7.1 
Prefer Parameterized Array Lists 


Parameterized array lists, such as ArrayList<BankAccount>, were introduced to the Java lan- 
guage in 2004. Versions of Java prior to version 5.0 had only an untyped class ArrayList. The 
untyped array list can hold elements of any class. (Technically, it holds elements of type 
Object, the “lowest common denominator” of all Java classes.) Whenever you retrieve an 
element from an untyped array list, the compiler requires you to use a cast: 


ArrayList accounts = new ArrayList(); // Untyped ArrayList 
accounts.add(new BankAccount(1729)) ; // OK—can add any object 
BankAccount a = (BankAccount) a.get(0); // Need cast 


The cast is needed because the compiler does not keep track of the objects that were inserted 
into the array list, and the array list get method has return type Object. 

Untyped array lists are still a part of the Java language —after all, we want to continue to 
use programs that were written before 2004. But you should not use them for new code. The 
casts are tedious and also a bit error-prone. If you apply the wrong cast, the compiler cannot 
detect your mistake. Instead, your program will throw an exception. 
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Because numbers are not objects in Java, you cannot directly insert 
them into array lists. For example, you cannot form an 
ArrayList<double>. To store sequences of numbers in an array list, 
you must turn them into objects by using wrapper classes. 

There are wrapper classes for all eight primitive types: 


Primitive Type Wrapper Class 


pe Byte 
boolean - Boolean 
char : Character — 
double Double 
=) float Float 
7 a 4 nt | . | , Intege . : - 
Tong Long 
i short | Short 


Note that the wrapper class names start with uppercase letters, and that two of 
them differ from the names of the corresponding primitive type: Integer and 
Character. 

Each wrapper class object contains a value of the corresponding primitive type. 
For example, an object of the class Double contains a value of type double (see 
Figure 5). 

Wrapper objects can be used anywhere that objects are required instead of prim- 
itive type values. For example, you can collect a sequence of floating-point numbers 
in an ArrayList<Double>. 


Figure 5 An Object of a Wrapper Class 
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Starting with Java version 5.0, conversion between primitive types and the corre- 
sponding wrapper classes is automatic. This process is called auto-boxing (even 
though auto-wrapping would have been more consistent). 

For example, if you assign a number to a Double object, the number is automati- 
cally “put into a box”, namely a wrapper object. 


Double d = 29.95; // auto-boxing; same as Double d = new Double(29.95); 


If you use an older version of Java, you need to provide the constructor yourself. 
Conversely, starting with Java version 5.0, wrapper objects are automatically 
“unboxed” to primitive types. 


double x = d; // auto-unboxing; same as double x = d.doubleValue(); 


With older versions, you need to call a method such as doubleValue, intValue, or 
booleanValue for unboxing. 

Auto-boxing even works inside arithmetic expressions. For example, the 
statement 


Double e = d + 1; 


is perfectly legal. It means: 


e Auto-unbox d into a double 
e Addi 
e Auto-box the result into a new Double 


e Store a reference to the newly created wrapper object in e 


If you use Java version 5.0 or higher, array lists of numbers are straightforward. 
Simply remember to use the wrapper type when you declare the array list, and then 
rely on auto-boxing. 


ArrayList<Double> data = new ArrayList<Double>Q; 
data.add(29.95); 
double x = data.get(0O); 


With older versions of Java, using wrapper classes to store numbers in an array list 
is a considerable hassle because you must manually box and unbox the numbers. 

No matter which Java version you use, you should know that storing wrapped 
numbers is quite inefficient. The use of wrappers is acceptable for short array lists, 
but you should use arrays for long sequences of numbers or characters. 


SELF CHECK 


5. What is the difference between the types double and Double? 


6. Suppose data is an ArrayList<Double> of size > 0. How do you increment the 
element with index 0? 
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Java version 5.0 introduces a very convenient shortcut for a common loop type. 
Often, you need to iterate through a sequence of elements—such as the elements of 
an array or array list. The enhanced for loop makes this process particularly easy to 
program. 

Suppose you want to total up all data values in an array data. Here 
is how you use the enhanced for loop to carry out that task. 


double[] data=.. .; 
double sum = 0; 

for (double e : data) 
{ 


} 


The loop body is executed for each element in the array data. At the beginning of 
each loop iteration, the next element is assigned to the variable e. Then the loop 
body is executed. You should read this loop as “for each e in data”. 

You may wonder why Java doesn’t let you write “for each (e in data)”. 
Unquestionably, this would have been neater, and the Java language designers seri- 
ously considered this. However, the “for each” construct was added to Java several 
years after its initial release. Had new keywords each and in been added to the lan- 
guage, then older programs that happened to use those identifiers as variable or 
method names (such as System. in) would no longer have compiled correctly. 

You don’t have to use the “for each” construct to loop through all elements in an 
array. You can implement the same loop with a straightforward for loop and an 
explicit index variable: 


sum = sum + e; 


double[] data=.. .; 
double sum = 0; 
for (int 71 = 0; 1 < data. length; i++) 
{ 
double e = data[i]; 
sum = sum + e; 


} 


Note an important difference between the “for each” loop and the ordinary for 
loop. In the “for each” loop, the element variable e is assigned values data[0], 
data[1], and so on. In the ordinary for loop, the index variable i is assigned values 
0, 1, and so on. 

You can also use the enhanced for loop to visit all elements of an array list. For 
example, the following loop computes the total value of all accounts: 


ArrayList<BankAccount> accounts =... ; 
double sum = 0; 
for (BankAccount a : accounts) 


{ 
} 


sum = sum + a.getBalance(); 
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This loop is equivalent to the following ordinary for loop: 


0; 
0; i < accounts.size(); i++) 


double sum 
for Cint 4 
{ 


BankAccount a = accounts.get(1); 
sum = sum + a.getBalance(); 


} 


The “for each” loop has a very specific purpose: traversing the elements of a collec- 
tion, from the beginning to the end. Sometimes you don’t want to start at the begin- 
ning, or you may need to traverse the collection backwards. In those situations, do 
not hesitate to use an ordinary for loop. 


SYNTAX 7.3 The “for each” Loop 


for (Type variable : collection) 
statement 


Example: 
for (double e : data) 
sum = sum + e; 


Purpose: 


To execute a loop for each element in the collection. In each iteration, the variable is 
assigned the next element of the collection. Then the statement is executed. 


SELF CHECK 


7. Write a “for each” loop that prints all elements in the array data. 


8. Why is the “for each” loop not an appropriate shortcut for the following 
ordinary for loop? 


for Cint i = 0; 1 < data.length; i++) data[i] = 71 * 1; 


=e 


| 


le 
36” gs Ee eat 


Suppose you want to find how many accounts of a certain type you 
have. Then you must go through the entire collection and increment 
a counter each time you find a match. Here we count the number of 
accounts whose balance is at least as much as a given threshold: 


public class Bank 


t 
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public int count(double atLeast) 


{ 
int matches = 0; 
for (BankAccount a : accounts) 
{ 
if Ca.getBalance() >= atLeast) matches++; 
// Found a match 
} 
return matches; 
} 


private ArrayList<BankAccount> accounts; 


Suppose you want to know whether there is a bank account with a 
particular account number in your bank. Simply inspect each ele- 
ment until you find a match or reach the end of the array list. Note 
that the loop might fail to find an answer, namely if none of the 
accounts match. This search process is called a linear search through 
the array list. 


public class Bank 


{ 
public BankAccount find(int accountNumber) 
q 
for (BankAccount a : accounts) 
{ 
if (a.getAccountNumber() == accountNumber) // Found a match 
return a; 
$ . e. ° 
return null; // No match in the entire array list 
} 
} 


Note that the method returns nu11 if no match is found. 


| Reedy 


Suppose you want to find the account with the largest balance in the 
bank. Keep a candidate for the maximum. If you find an element 
with a larger value, then replace the candidate with that value. When 
you have reached the end of the array list, you have found the 
maximum. 

There is just one problem. When you visit the beginning of the 
array, you don’t yet have a candidate for the maximum. One way to 
overcome that is to set the candidate to the starting element of the 
array and start the comparison with the next element. 
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BankAccount largestYet = accounts.get(0); 
for Cint 1 = 1; 1 < accounts.size(); i++) 


{ 
BankAccount a = accounts.get(1); 
if (a.getBalance() > largestYet.getBalance() ) 
largestYet = a; 
} 


return largestYet; 


Now we use an explicit for loop because the loop no longer visits all elements —it 
skips the starting element. 

Of course, this approach works only if there is at least one element in the array 
list. It doesn’t make a lot of sense to ask for the largest element of an empty collec- 
tion. We can return nu11 in that case: 


if Caccounts.sizeQ) == 0) return null; 
BankAccount largestYet = accounts.get(0); 


See Exercises R7.5 and R7.6 for slight modifications to this algorithm. 

To compute the minimum of a data set, keep a candidate for the minimum and 
replace it whenever you encounter a smaller value. At the end of the array list, you 
have found the minimum. 

The following sample program implements a Bank class that stores an array list of 
bank accounts. The methods of the Bank class use the algorithms that we have dis- 
cussed in this section. 


ch07/bank/Bank.java 
l import java.util.ArrayList; 
2 
3 


This bank contains a collection of bank accounts. 


ale 
n“ 


4 
5 
6 public class Bank 
7 
8 


{ 
dad - 
9 Constructs a bank with no bank accounts. 

10 * / 
11 public Bank() 
12 { 
13 accounts = new ArrayList<BankAccount>Q() ; 
14 } 
15 
16 wi 
17 Adds an account to this bank. 
18 @param a the account to add 
19 * 
20 public void addAccount(BankAccount a) 
21 { 
22 accounts.add(a); 
23 } 
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Gets the sum of the balances of all accounts in this bank. 
@return the sum of the balances 


* J 
public double getTotalBalance() 


{ 
double total = 0; 
for (BankAccount a : accounts) 
{ 
total = total + a.getBalanceQ() ; 
t 
return total; 
} 
/ *F 


Counts the number of bank accounts whose balance is at 

least a given value. 

@param atLeast the balance required to count an account 
@return the number of accounts having at least the given balance 


public int count(double atLeast) 


{ 
int matches = 0; 
for (BankAccount a : accounts) 
{ 
if (a.getBalance() >= atLeast) matches++; // Found a match 
return matches; 
} 
j™ 


Finds a bank account with a given number. 
@param accountNumber the number to find 
@return the account with the given number, or nu11 if there 
is no such account 


public BankAccount find(int accountNumber) 


if 
for (BankAccount a : accounts) 
t 
if (a.getAccountNumber() == accountNumber) // Found a match. 
return a; 
5 * * . 
return null; // No match in the entire array list 
} 
[*? 


Gets the bank account with the largest balance. 
@return the account with the largest balance, or nu11 if the 
bank has no accounts 


public BankAccount getMaximum() 


{ 
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78 if (accounts.sizeQ) == 0) return null; 
79 BankAccount largestYet = accounts.get(0); 
80 for Cint i = 1; i < accounts.size(); i++) 
81 

82 BankAccount a = accounts.get(i); 

83 if C(a.getBalance() > largestYet.getBalance()) 
84 largestYet = a; 

85 } 

86 return largestYet; 

87 } 

88 

89 private ArrayList<BankAccount> accounts; 

90 } 


ch07/bank/BanktTester.java 
/* rd 


; | This program tests the Bank class. 

; ie class BankTester 

; public static void main(String[] args) 
Bank firstBankOfJava = new BankQ); 


firstBankOfJava.addAccount(new BankAccount(l001, 20000)); 


10 firstBankOfJava.addAccount(new BankAccount(1015, 10000)); 
11 firstBankOfJava.addAccount(new BankAccount(1729, 15000)); 
12 

13 double threshold = 15000; 

14 int c = firstBankOfJava.count(threshold); 

15 System.out.printInC"Count: " + ¢); 

16 System.out.printInC"Expected: 2"); 

17 

18 int accountNumber = 1015; 

19 BankAccount a = firstBankOfJava.find(accountNumber) ; 
20 if (a == null) 

21 System.out.printInC'No matching account"); 

22 else 

23 System.out.printInC"Balance of matching account: " 
24 + a.getBalance()); 

25 System.out.printInC"Expected: 10000"); 

26 

27 BankAccount max = firstBankOfJava.getMaximum() ; 

28 System.out.printiInC"Account with largest balance: " 
29 + max.getAccountNumber()); 

30 System.out.printInC'Expected: 1001"); 

31 
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Output 
Count: 2 
Expected: 2 


Balance of matching account: 10000.0 
Expected: 10000 

Account with largest balance: 1001 
Expected: 1001 


SELF CHECK 


9. What does the find method do if there are two bank accounts with a matching 
account number? 


10. Would it be possible to use a “for each” loop in the getMaximum method? 


Arrays and array lists can store linear sequences. Occasionally you want to store 
collections that have a two-dimensional layout. The traditional example is the tic- 
tac-toe board (see Figure 6). 
cnepnccaa Such an arrangement, consisting of rows and columns of values, is 
called a two-dimensional array or matrix. When constructing a two- 
dimensional array, you specify how many rows and columns you 
need. In this case, ask for 3 rows and 3 columns: 

final int ROWS = 3; 

final int COLUMNS = 3; 

String[][] board = new String[ROWS] [COLUMNS] ; 


This yields a two-dimensional array with 9 elements 


board[0] [0] board[0] [1] board[0] [2] 
board[1] [0] board[1] [1] board[1] [2] 
board[2][0] board[2][1] board[2][2] 


To access a particular element, specify two subscripts in separate brackets: 
board[i][j] = "x"; 


When filling or searching a two-dimensional array, it is common to use two nested 
loops. For example, this pair of loops sets all elements in the array to spaces. 
for Cint 71 = 0; 1 < ROWS; 1++) 


for (int j = 0; j < COLUMNS; j++) 
board[iJ[j] =" "; 


Figure 6 
A Tic-Tac-Toe Board 
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Here is a class and a test program for playing tic-tac-toe. This class does not check 
whether a player has won the game. That is left as the proverbial “exercise for the 
reader” —see Exercise P7.10. 


ch07/twodim/TicTacToe.java 


Ll /** 

2 A 3 x3 tic-tac-toe board. 

3 vw 

4 public class TicTacToe 

5 { 

6 [** 

c Constructs an empty board. 

8 e 

9 public TicTacToe() 

10 f 

11 board = new String[ROWS] [COLUMNS] ; 
12 // Fill with spaces 

13 for (int i = 0; 7 < ROWS; i144) 

14 for Cint j = 0; j < COLUMNS; j++) 
15 board[i]J[j] =" "; 

16 } 

17 

18 ce 

19 Sets a field in the board. The field must be unoccupied. 
20 @param i the row index 

21 @param j the column index 

ze @param player the player ("x" or "o") 
23 by 

24 public void set(int i, int j, String player) 
25 { 

26 if Cboard[i][j].equalsc" ")) 

zi board[i][j] = player; 

28 } 

29 

30 ie 

31 Creates a string representation of the board, such as 
32 |x o| 

33 | x | 

34 | o|. 

35 @return the string representation 

36 ad 

37 public String toString() 

38 { 

39 String r=""; 
40 for Cint i = 0; i < ROWS; i++) 
41 { 
42 r=r4"("; 
43 for Cint j = 0; j < COLUMNS; j++) 
44 r=r + board[i][jl; 
45 r=r+"|\n"; 
46 } 
47 return r; 
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49 

50 private String[][] board; 

51 private static final int ROWS = 3; 
52 private static final int COLUMNS = 3; 
53 } 


ch07/twodim/TicTacToeRunner.java 


1 import java.util.Scanner; 


3 /** 
This program runs a TicTacToe game. It prompts the 
user to set positions on the board and prints out the 


4 
5 
6 result. 
7 
8 


% 
/ 
public class TicTacToeRunner 

9 { 

10 public static void main(String[] args) 
11 { 

12 Scanner in = new Scanner(System.in); 
13 String player = "x"; 

14 TicTacToe game = new TicTacToe(); 
15 boolean done = false; 
16 while (!done) 
17 { 
18 System.out.print(game.toString()) ; 
19 System.out.print( 
20 "Row for " + player + " (-1 to exit): "); 
Zi int row = in.nextIntQ; 
22 if Crow < 0) done = true; 
23 else 
24 { 
25 System.out.printC"Column for " + player + ": °); 
26 int column = in.nextIntQ); 
ai game.set(row, column, player); 
28 if (player.equals('"'x')) 
29 player = "o'; 
30 else 
31 player = "x"; 
32 } 
33 } 
34 } 
33} 
Output 


Row for x (-1 to exit): 1 
Column for x: 2 


|x| 
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Row for o (-1 to exit): 0 
Column for o: Q 

jo | 

| x| 


Row for x (-1 to exit): - 


SELF CHECK 


11. How do you declare and initialize a 4-by-4 array of integers? 


12. How do you count the number of spaces in the tic-tac-toe board? 


How To 7.1 


Working with Array Lists and Arrays 


Step 1 Pick the appropriate data structure. 


As a rule of thumb, your first choice should be an array list. Use an array if you collect num- 
bers (or other primitive type values) and efficiency is an issue, or if you need a two- 
dimensional array. 


Step 2. Construct the array list or array and save a reference in a variable. 


For both array lists and arrays, you need to specify the element type. For an array, you also 
need to specify the length. 


ArrayList<BankAccount> accounts = new ArrayList<BankAccount>(); 
double[] balances = new double[n]; 


Step 3. Add elements. 


For an array list, simply call the add method. Each call adds an element at the end. 


accounts.add(new BankAccount(1008)) ; 
accounts.add(new BankAccount(1729)); 


For an array, you use index values to access the elements. 


balance[0] = 29.95; 
balance[1] 1000; 


Step 4. Process elements. 


The most common processing pattern involves visiting all elements in the collection. Use the 
“for each” loop for this purpose: 


for (BankAccount a : accounts) 
Do something with a 


If you don’t need to look at all of the elements, use an ordinary loop instead. For example, to 
skip the initial element, you can use this loop. 


for Cint i = 1; i < accounts.size(); i++) 
{ 
BankAccount a = accounts.get(i); 
Do something with a 
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} 
For arrays, you use . length instead of .size() and [i] instead of .get (i). 


ADVANCED TOPIC 7.2 


Two-Dimensional Arrays with Variable Row Lengths 


When you declare a two-dimensional array with the command 
int{](] a = new int[5][5]; 

then you get a 5-by-5 matrix that can store 25 elements: 
af0][0] afO][1] a[0][2] af0][3] alo][4] 
a[1][0] a{1][1] af[1](2] af{i](3] afi) [4] 
a[2](0] a{2](1] af2][2] al[2][3] a{2][4] 


a[3][0] a[3](1] a[3][2] al3][3] al3][4] 
al4][0] a[4][1] a[4][2] al[4][3] al4][4] 


In this matrix, all rows have the same length. In Java it is possible to declare arrays in which 
the row length varies. For example, you can store an array that has a triangular shape, such as: 


b[0] [0] 

b[1](0] b{1}[1] 

b(2][0] bL2]}[1] bl2][2] 

b[3](0] b[3](1] bL3]}[2] bL3]L3] 
b[4][0] b[4][1] bL4][2] bL4][3] bL4][4] 


To allocate such an array, you must work harder. First, you allocate space to hold five rows. 
Indicate that you will manually set each row by leaving the second array index empty: 


int{][] b = new int[5](]; 
Then allocate each row separately. 


for Cint i = 0; i < b. length; i++) 
b[i] = new int[i + 1]; 


You can access each array element as b[i] [j], but be careful that j is less than b[i] . length. 
Naturally, such “ragged” arrays are not very common. 


ADVANCED TOPIC 7.3 


Multidimensional Arrays 


You can declare arrays with more than two dimensions. For example, here is a three- 
dimensional array: 


int{][J][] rubiksCube = new int[3][3](3]; 
Each array element is specified by three index values, 
rubiksCube[i][j] [k] 


However, these arrays are quite rare, particularly in object-oriented programs, and we will 
not consider them further. 
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Array variables work just like object variables—they hold a reference 
to the actual array. If you copy the reference, you get another refer- 
ence to the same array (see Figure 7): 


double[] data = new double[10]; 
// Fill array 
double[] prices = data; 


If you want to make a true copy of an array, call the clone method 
(see Figure 8). 


double[] prices = (double[]) data.clone(); 


The clone method (which we will more closely study in Chapter 10) 
has the return type Object. You need to cast the return value of the clone method to 
the appropriate array type such as double[]. 


Figure 8 Cloning an Array 
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Figure 9 The System.arraycopy Method 


Occasionally, you need to copy elements from one array into 
another array. You can use the static System.arraycopy method for 
that purpose (see Figure 9): 


System.arraycopy(from, fromStart, to, toStart, count); 


One use for the System. arraycopy method is to add or remove elements in the mid- 
dle of an array. To add a new element at position i into data, first move all elements 
from i onward one position up. Then insert the new value. 

System.arraycopy(data, i, data, i + 1, data.length - i - 1); 

data[i] = x; 
Note that the last element in the array is lost (see Figure 10). 

To remove the element at position i, copy the elements above the position down- 
ward (see Figure 11). 


System.arraycopy(data, i+ 1, data, i, data.length - 1 - 1); 
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data. length - i - 1 


Figure 10 Inserting a New Element into an Array 


data. length - i - 1 


Figure 11. Removing an Element from an Array 


Another use for System.arraycopy is to grow an array that has run out of space. 
Follow these steps: 


e Create a new, larger array. 
double[] newData = new double[2 * data. length]; &p 


e Copy all elements into the new array 
System.arraycopy(data, 0, newData, 0, data.length); 2) 


e Store the reference to the new array in the array variable. 
data = newData; (3) 


Figure 12 shows the process. 
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Figure 12 Growing an Array 


SELF CHECK 


13. How do you add or remove elements in the middle of an array list? 
14. Why do we double the length of the array when it has run out of space rather 


than increasing it by one element? 
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COMMON ERROR 7.4 


Underestimating the Size of a Data Set 


Programmers commonly underestimate the amount of input data that a user will pour into 
an unsuspecting program. The most common problem caused by underestimating the 
amount of input data results from the use of fixed-sized arrays. Suppose you write a program 
to search for text in a file. You store each line in a string, and keep an array of strings. How 
big do you make the array? Surely nobody is going to challenge your program with an input 
that is more than 100 lines. Really? A smart grader can easily feed in the entire text of Alice in 
Wonderland or War and Peace (which are available on the Internet). All of a sudden, your 
program has to deal with tens or hundreds of thousands of lines. What will it do? Will it han- 
dle the input? Will it politely reject the excess input? Will it crash and burn? 

A famous article [1] analyzed how several UNIX programs reacted when they were fed 
large or random data sets. Sadly, about a quarter didn’t do well at all, crashing or hanging 
without a reasonable error message. For example, in some versions of UNIX the tape 
backup program tar cannot handle file names that are longer than 100 characters, which is a 
pretty unreasonable limitation. Many of these shortcomings are caused by features of the C 
language that, unlike Java, make it difficult to store strings of arbitrary size. 


QUALITY TIP 7.2 


Make Parallel Arrays into Arrays of Objects 


Programmers who are familiar with arrays, but unfamiliar with object- oriented program- 
ming, sometimes distribute information across separate arrays. Here is a typical example. A 
program needs to manage bank data, consisting of account numbers and balances. Don’t 
store the account numbers and balances in separate arrays. 


// Don’t do this 
int[] accountNumbers; 
double[] balances; 


Arrays such as these are called parallel arrays (see Avoid Parallel Arrays). The ith slice 
(accountNumbers[i] and balances[i]) contains data that need to be processed together. 


Avoid Parallel Arrays 
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Reorganizing Parallel Arrays into an Array of Objects 


If you find yourself using two arrays that have the same 
length, ask yourself whether you couldn’t replace them with 
a single array of a class type. Look at a slice and find the con- 
cept that it represents. Then make the concept into a class. In 
our example each slice contains an account number and a bal- 
ance, describing a bank account. Therefore, it is an easy matter to use a single array of objects 


BankAccount[] accounts; 


(See figure above.) Or, even better, use an ArrayList<BankAccount>. 

Why is this beneficial? Think ahead. Maybe your program will change and you will need 
to store the owner of the bank account as well. It is a simple matter to update the 
BankAccount class. It may well be quite complicated to add a new array and make sure that all 
methods that accessed the original two arrays now also correctly access the third one. 


ADVANCED TOPIC 7.4 


Partially Filled Arrays 


Suppose you write a program that reads a sequence of numbers into an array. How many 
numbers will the user enter? You can’t very well ask the user to count the items before enter- 
ing them—that is just the kind of work that the user expects the computer to do. Unfortu- 
nately, you now run into a problem. You need to set the size of the array before you know 
how many elements you need. Once the array size is set, it cannot be changed. 

To solve this problem, make an array that is guaranteed to be larger than the largest possi- 
ble number of entries, and partially fill it. For example, you can decide that the user will 
never enter more than 100 data values. Then allocate an array of size 100: 


final int DATA_LENGTH = 100; 
double[] data = new double[DATA_LENGTH] ; 


Then keep a companion variable that tells how many elements in the array are actually used. 
It is an excellent idea always to name this companion variable by adding the suffix Size to 
the name of the array. 


int dataSize = 0; 
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A Partially Filled Array 


Now data. length is the capacity of the array data, and dataSize is the current size of the 
array (see A Partially Filled Array). Keep adding elements into the array, incrementing the 
dataSize variable each time. 


data[dataSize] = x; 
dataSize++; 


This way, dataSize always contains the correct element count. When you run out of space, 
make a new array and copy the elements into it, as described in the preceding section. 

Array lists use this technique behind the scenes. An array list contains an array of objects. 
When the array runs out of space, the array list allocates a larger array and copies the data. 
However, all of this happens inside the array list methods, so you never need to think about it. 


ADVANCED Topic 7.5 


Methods with a Variable Number of Parameters 


Starting with Java version 5.0, it is possible to declare methods that receive a variable number 
of parameters. For example, we can modify the add method of the DataSet class of Chapter 6 
so that one can add any number of values: 


data.add(1, 3, 7); 
data.add(4); 
data.add(); // OK but not useful 


The modified add method must be declared as 
public void add(double... xs) 


The ... symbol indicates that the method can receive any number of double values. The xs 
yr ve any 

parameter is actually a double[] array that contains all values that were passed to the 

method. The method implementation traverses the parameter array and processes the values: 


Tor (x = XS) 
{ 


sum = SUM + X, 
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RANDOM FACT 7.1 


An Early Internet Worm 


In November 1988, a graduate student at Cornell University launched a virus program that 
infected about 6,000 computers connected to the Internet across the United States. Tens of 
thousands of computer users were unable to read their e-mail or otherwise use their comput- 
ers. All major universities and many high-tech companies were affected. (The Internet was 
much smaller then than it is now.) 

The particular kind of virus used in this attack is called a worm. The virus program 
crawled from one computer on the Internet to the next. The entire program is quite complex; 
its major parts are explained in [2]. However, one of the methods used in the attack is of 
interest here. The worm would attempt to connect to finger, a program in the UNIX operat- 
ing system for finding information ona user who has an account on a particular computer on 
the network. Like many programs in UNIX, finger was written in the C language. C does 
not have array lists, only arrays, and when you construct an array in C, as in Java, you have 
to make up your mind how many elements you need. To store the user name to be looked up 
(say, walters@cs.sjsu.edu), the finger program allocated an array of 512 characters, under 
the assumption that nobody would ever provide such a long input. Unfortunately, C, unlike 
Java, does not check that an array index is less than the length of the array. If you write into 
an array, using an index that is too large, you simply overwrite memory locations that belong 
to some other objects. In some versions of the finger program, the programmer had been 
lazy and had not checked whether the array holding the input characters was large enough to 
hold the input. So the worm program purposefully filled the 512-character array with 536 
bytes. The excess 24 bytes would overwrite a return address, which the attacker knew was 
stored just after the line buffer. When that function was finished, it didn’t return to its caller 
but to code supplied by the worm (see A “Buffer Overrun” Attack). That code ran under the 
same super-user privileges as finger, allowing the worm to gain entry into the remote 
system. 

Had the programmer who wrote finger been more conscientious, this particular attack 
would not be possible. In C++ and C, all programmers must be especially careful not to 
overrun array boundaries. 

One may well wonder what would possess a skilled programmer to spend many weeks or 
months to plan the antisocial act of breaking into thousands of computers and disabling 
them. It appears that the break-in was fully intended by the author, but the disabling of the 
computers was a side effect of continuous reinfection and efforts by the worm to avoid being 


Return address —_ Return address _ - — 


Line buffer Overrun buffer 
(512 bytes) (536 bytes) —— 


A “Buffer Overrun” Attack 
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killed. It is not clear whether the author was aware that these moves would cripple the 
attacked machines. 

In recent years, the novelty of vandalizing other people’s computers has worn off some- 
what, and there are fewer jerks with programming skills who write new viruses. Other 
attacks by individuals with more criminal energy, whose intent has been to steal information 
or money, have surfaced. See [3] for a very readable account of the discovery and apprehen- 
sion of one such person. 


It is a common and useful practice to make a new test whenever you 
find a program bug. You can use that test to verify that your bug fix 
really works. Don’t throw the test away; feed it to the next version 
after that and all subsequent versions. Such a collection of test cases 
is called a test suite. 

You will be surprised how often a bug that you fixed will reappear 
in a future version. This is a phenomenon known as cycling. Some- 
times you don’t quite understand the reason for a bug and apply a 
quick fix that appears to work. Later, you apply a different quick fix 
that solves a second problem but makes the first problem appear 
again. Of course, it is always best to think through what really causes 
a bug and fix the root cause instead of doing a sequence of “Band-Aid” solutions. If 
you don’t succeed in doing that, however, you at least want to have an honest 
appraisal of how well the program works. By keeping all old test cases around and 
testing them against every new version, you get that feedback. The process of test- 
ing against a set of past failures is called regression testing. 

How do you organize a suite of tests? An easy technique is to produce multiple 
tester classes, such as BankTester1, BankTester2, and so on. 

Another useful approach is to provide a generic tester, and feed it inputs from 
multiple files. Consider this tester for the Bank class of Section 7.5: 


ch07/regression/BankTester.java 


l fr 

2 This program tests the Bank class. 

3 ; 

4 public class BankTester 

5 6 

6 public static void main(String[] args) 

7 { 

8 Bank firstBankOfJava = new Bank(); 

9 firstBankOfJava.addAccount(new BankAccount(1001, 20000)); 
10 firstBankOfJava.addAccount(new BankAccount(i015, 10000)); 
11 firstBankOfJava.addAccount(new BankAccount(1729, 15000));3 
12 
13 Scanner in = new Scanner(System. in); 
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15 double threshold = in.nextDouble(); 

16 int c = firstBankOfJava.count(threshold); 

17 System.out.printinC"Count: " + c); 

18 int expectedCount = in.nextInt(); 

19 System.out.printInC"Expected: '" + expectedCount) ; 

20 

21 int accountNumber = in.nextInt; 

22 BankAccount a = firstBankOfJava.find(accountNumber) ; 
23 if (a == null) 

24 System.out.printInC"No matching account"); 

25 else 

26 { 

Zf System.out.printIn("Balance of matching account: " 
28 + a.getBalance()); 

29 int matchingBalance = in.nextLine(); 

30 System.out.printIn("Expected: " + matchingBalance); 
31 } 

32 li 

33 


Rather than using fixed values for the threshold and the account number to be 
found, the program reads these values, and the expected responses. By running the 
program with different inputs, we can test different scenarios, such as the ones for 
diagnosing off-by-one errors discussed in Common Error 6.2. 

Of course, it would be tedious to type in the input values by hand every time the 
test 1s executed. It is much better to save the inputs ina file, such as the following: 


ch07/regression/input1.txt 


15000 
2 
1015 
10000 


The command line interfaces of most operating systems provide a way to link a 
file to the input of a program, as if all the characters in the file had actually been 
typed by a user. Type the following command into a shell window: 


java BankTester < inputl.txt 


The program is executed, but it no longer reads input from the keyboard. Instead, 
the System. in object (and the Scanner that reads from System. in) gets the input from 
the file input1.txt. This process is called input redirection. 

The output is still displayed in the console window: 


Output 
Count? .Z 
Expected: 2 


Balance of matching account: 10000 
Expected: 10000 
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You can also redirect output. To capture the output of a program in a file, use the 
command 


java BankTester < inputl.txt > outputl.txt 


This is useful for archiving test cases. 


SELF CHECK 


15. Suppose you modified the code for a method. Why do you want to repeat tests 
that already passed with the previous version of the code? 


16. Suppose a customer of your program finds an error. What action should you 
take beyond fixing the error? 


17. Why doesn’t the BankTester program contain prompts for the inputs? 


PRODUCTIVITY HINT 7.1 


Batch Files and Shell Scripts 


If you need to perform the same tasks repeatedly on the command line, then it 1s worth 
learning about the automation features offered by your operating system. 

Under Windows, you use batch files to execute a number of commands automatically. 
For example, suppose you need to test a program by running three testers: 


java BankTesterl 
java BankTester2 
java BankTester3 < inputl.txt 


Then you find a bug, fix it, and run the tests again. Now you need to type the three com- 
mands once more. There has to be a better way. Under Windows, put the commands in a text 
file and call it test.bat: 


File test.bat 


1 java BankTester1l 
2 java BankTester2 
3 java BankTester3 < inputl.txt 


Then you just type 
test. bat 


and the three commands in the batch file execute automatically. 

Batch files are a feature of the operating system, not of Java. On Linux, Mac OS, and 
UNIX, shell scripts are used for the same purpose. In this simple example, you can execute 
the commands by typing 


sh test.bat 


There are many uses for batch files and shell scripts, and it is well worth it to learn more 
about advanced features such as parameters and loops. 
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RANDOM FACT 7.2 


The Therac-25 Incidents 


The Therac-25 is a computerized device to deliver radiation treatment to cancer patients (see 
Typical Therac-25 Facility). Between June 1985 and January 1987, several of these machines 
delivered serious overdoses to at least six patients, killing some of them and seriously maim- 
ing the others. 

The machines were controlled by a computer program. Bugs in the program were directly 
responsible for the overdoses. According to Leveson and Turner [4], the program was writ- 
ten by a single programmer, who had since left the manufacturing company producing the 
device and could not be located. None of the company employees interviewed could say 
anything about the educational level or qualifications of the programmer. 

The investigation by the federal Food and Drug Administration (FDA) found that the 
program was poorly documented and that there was neither a specification document nor a 
formal test plan. (This should make you think. Do you have a formal test plan for your 
programs?) 

The overdoses were caused by an amateurish design of the software that had to control 
different devices concurrently, namely the keyboard, the display, the printer, and of course 
the radiation device itself. Synchronization and data sharing between the tasks were done in 
an ad hoc way, even though safe multitasking techniques were known at the time. Had the 
programmer enjoyed a formal education that involved these techniques, or taken the effort 
to study the literature, a safer machine could have been built. Such a machine would have 
probably involved a commercial multitasking system, which might have required a more 
expensive computer. 

The same flaws were present in the software controlling the predecessor model, the 
Therac-20, but that machine had hardware interlocks that mechanically prevented overdoses. 


Room Motion Therapy room 
emergency power switch intercom 
TV switches | 
camera 
Therac-25 unit 
Beam 
on/off light 
Door 
interlock 
switch 
Room 
emergency 
switch 
Treatment table 
Display 
terminal 
TV monitor Printer Turntable 
Motion enable Control position 
switch (footswitch) console monitor 


Typical Therac-25 Facility 
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The hardware safety devices were removed in the Therac-25 and replaced by checks in the 
software, presumably to save cost. 

Frank Houston of the FDA wrote in 1985: “A significant amount of software for life- 
critical systems comes from small firms, especially in the medical device industry; firms that 
fit the profile of those resistant to or uninformed of the principles of either system safety or 
software engineering” [4]. 

Who is to blame? The programmer? The manager who not only failed to ensure that the 
programmer was up to the task but also didn’t insist on comprehensive testing? The hospi- 
tals that installed the device, or the FDA, for not reviewing the design process? Unfortu- 
nately, even today there are no firm standards of what constitutes a safe software design 


process. 


_ CHAPTER SUMMARY | 


1. An array is a sequence of values of the same type. 
2. You access array elements with an integer index, using the notation a[i]. 


3. Index values of an array range from 0 to length - 1. Accessing a nonexistent 
element results in a bounds error. 


4. Use the length field to find the number of elements in an array. 

5. The ArrayList class manages a sequence of objects. 

6. The ArrayList class is a generic class: ArrayList<T> collects objects of type T. 
7. To treat primitive type values as objects, you must use wrapper classes. 

8. The enhanced for loop traverses all elements of a collection. 


9. To count values in an array list, check all elements and count the matches until 
you reach the end of the array list. 


10. To find a value in an array list, check all elements until you have found a match. 


11. To compute the maximum or minimum value of an array list, initialize a candi- 
date with the starting element. Then compare the candidate with the remaining 
elements and update it if you find a larger or smaller value. 


12. Two-dimensional arrays form a tabular, two-dimensional arrangement. You 
access elements with an index pair a[i] [J]. 


13. An array variable stores a reference to the array. Copying the variable yields a 
second reference to the same array. 


14. Use the clone method to copy the elements of an array. 
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15. Use the System.arraycopy method to copy elements from one array to another. 


16. Avoid parallel arrays by changing them into arrays of objects. 


17. A test suite is a set of tests for repeated testing. 


18. Regression testing involves repeating previously run tests to ensure that known 


failures of prior versions do not appear in new versions of the software. 
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CLASSES, OBJECTS, AND METHODS 
INTRODUCED IN THIS CHAPTER. 


java. lang.Boolean java.util .ArrayList<E> 
booleanValue add 
java. lang.Double get 
doubleValue remove 
java. lang. Integer set 
intValue size 
java. lang.System 
arraycopy 


REVIEW EXERCISES | 


Exercise R7.1. What is an index? What are the bounds of an array or array list? What 
is a bounds error? 


Exercise R7.2. Write a program that contains a bounds error. Run the program. What 
happens on your computer? How does the error message help you locate the error? 


Exercise R7.3. Write Java code for a loop that simultaneously computes the maxi- 
mum and minimum values of an array list. Use an array list of accounts as an 
example. 
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Exercise R7.4. Write a loop that reads 10 strings and inserts them into an array list. 
Write a second loop that prints out the strings in the opposite order from which 
they were entered. 


Exercise R7.5. Consider the algorithm that we used for determining the maximum 
value in an array list. We set largestYet to the starting element, which meant that 
we were no longer able to use the “for each” loop. An alternate approach 1s to 
initialize largestYet with nu11, then loop through all elements. Of course, inside the 
loop you need to test whether largestYet is still nu11. Modify the loop that finds the 
bank account with the largest balance, using this technique. Is this approach more 
or less efficient than the one used in the text? 


Exercise R7.6. Consider another variation of the algorithm for determining the maxi- 
mum value. Here, we compute the maximum value of an array of numbers. 


double max = 0; // Contains an error! 
for (x : values) 


{ 
if (x > max) max = x; 


} 
However, this approach contains a subtle error. What is the error, and how can you 
fix it? 


Exercise R7.7. For each of the following sets of values, write code that fills an array a 
with the values. 


a 12345678910 
b. 024681012 14 1618 20 
ce. 149 16 25 36 49 64 81 100 
d.0000000000 
& 149169747 11 


Use a loop when appropriate. 


Exercise R7.8. Write a loop that fills an array a with 10 random numbers between 1 
and 100. Write code (using one or more loops) to fill a with 10 different random 
numbers between 1 and 100. 


Exercise R7.9. What is wrong with the following loop? 


double[] data = new double[10]; 
for (int i = 1; 7 <= 10; i++) data[i] = 71 * 1; 


Explain two ways of fixing the error. 


Exercise R7.10. Write a program that constructs an array of 20 integers and fills the 
first ten elements with the numbers 1, 4, 9,..., 100. Compile it and launch the 
debugger. After the array has been filled with three numbers, inspect it. What are 
the contents of the elements in the array beyond those that you filled? 
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Exercise R7.11. Rewrite the following loops without using the “for each” construct. 
Here, data is an array of double values. 


a. 
b. 
C. 


for (x : data) sum = sum + x; 
for (x : data) if (x == target) return true; 


int 1 = 0; 
for (x : data) { data [i] = 2 * x; i++: } 


Exercise R7.12. Rewrite the following loops, using the “for each” construct. Here, 
data is an array of double values. 


a. 
b. 
C. 


for (int i = 0; i < data.length; i++) sum = sum + data[i]; 
for (int i = 1; i < data.length; i++) sum = sum + data[il; 


for Cint.71 = 03 7 <= data. length: 14+) 
if (data[i] == target) return i; 


Exercise R7.13. Give an example of 


d. 


b. 
c. 


A useful method that has an array of integers as a parameter that is not 


modified. 
A useful method that has an array of integers as a parameter that is modified. 


A useful method that has an array of integers as a return value. 


Describe each method; don’t implement the methods. 


Exercise R714. A method that has an array list as a parameter can change the con- 
tents in two ways. It can change the contents of individual array elements, or it can 
rearrange the elements. Describe two useful methods with ArrayList<BankAccount> 
parameters that change an array list of BankAccount objects in each of the two ways 
just described. 


Exercise R7.15. What are parallel arrays? Why are parallel arrays indications of poor 
programming? How can they be avoided? 


Exercise R7.16. How do you perform the following tasks with arrays in Java? 


a. 
b. 
C. 
d. 


Test that two arrays contain the same elements in the same order 
Copy one array to another 
Fill an array with zeroes, overwriting all elements in it 


Remove all elements from an array list 


Exercise R7.17. True or false? 


d. 


> oa0o & 


All elements of an array are of the same type. 


. Array subscripts must be integers. 


Arrays cannot contain string references as elements. 


. Arrays cannot use strings as subscripts. 


Parallel arrays must have equal length. 


Two-dimensional arrays always have the same numbers of rows and columns. 


tok 
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g. Two parallel arrays can be replaced by a two-dimensional array. 
h. Elements of different columns in a two-dimensional array can have different 
types. 
Exercise R7.18. True or false? 
a. A method cannot return a two-dimensional array. 
b. A method can change the length of an array parameter. 
c. A method can change the length of an array list that is passed as a parameter. 
d. An array list can hold values of any type. 


Exercise R7.19. Define the terms regression testing and test suite. 


Exercise R7.20. What is the debugging phenomenon known as cycling? What can you 
do to avoid it? 


Additional review exercises are available in WileyPLUS. 


PROGRAMMING EXERCISES 


Exercise P7.1. Add the following methods to the Bank class: 


public void addAccount(int accountNumber, double initialBalance) 
public void deposit(int accountNumber, double amount) 

public void withdraw(int accountNumber, double amount) 

public double getBalance(int accountNumber ) 


Exercise P7.2. Implement a class Purse. A purse contains a collection of coins. For 
simplicity, we will only store the coin names in an ArrayList<String>. (We will dis- 
cuss a better representation in Chapter 8.) Supply a method 


void addCoin(String coinName) 


Add a method toString to the Purse class that prints the coins in the purse in the 
format 


Purse[Quarter,Dime,Nickel ,Dime] 


Exercise P7.3. Write a method reverse that reverses the sequence of coins 1n a purse. 
Use the toString method of the preceding assignment to test your code. For exam- 
ple, if reverse is called with a purse 


Purse[Quarter,Dime,Nickel ,Dime] 
then the purse is changed to 
Purse[Dime,Nickel ,Dime, Quarter] 
Exercise P7.4. Add a method to the Purse class 
public void transfer(Purse other) 
that transfers the contents of one purse to another. For example, if a 1s 


Purse[Quarter,Dime,Nickel ,Dime] 
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and b is 
Purse[Dime,Nickel ] 

then after the call a. transfer(b), a is 
Purse[Quarter,Dime,Nickel,Dime,Dime,Nickel] 

and b is empty. 

Exercise P7.5. Write a method for the Purse class 
public boolean sameContents(Purse other) 


that checks whether the other purse has the same coins in the same order. 


Exercise P7.6. Write a method for the Purse class 
public boolean sameCoins(Purse other) 


that checks whether the other purse has the same coins, perhaps in a different order. 
For example, the purses 


Purse[Quarter,Dime,Nickel ,Dime] 
and 

Purse[Nickel ,Dime,Dime, Quarter] 
should be considered equal. 


You will probably need one or more helper methods. 


Exercise P7.7. A Polygon is a closed curve made up from line segments that join the 
polygon’s corner points. Implement a class Polygon with methods 


public double perimeter() 
and 
public double area() 


that compute the circumference and area of a polygon. To compute the perimeter, 
compute the distance between adjacent points, and total up the distances. The area 
of a polygon with corners (xo; Vo), « «+5 (Xp—15 Vy_1) IS 


1 

5 (801 + 12 FF Xp ~ JoX — M42 ~ = In—1%o) 
As test cases, compute the perimeter and area of a rectangle and of a regular 
hexagon. Note: You need not draw the polygon—that is done in Exercise P7.15. 


Exercise P7.8. Write a program that reads a sequence of integers into an array and 
that computes the alternating sum of all elements in the array. For example, if the 
program 1s executed with the input data 


149 1464 9 7 4 9 11 
then it computes 


1-44+9-16+9-7+4+4-9411=-2 
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Exercise P7.9. Write a program that produces random permutations of the numbers 
1 to 10. To generate a random permutation, you need to fill an array with the 
numbers 1 to 10 so that no two entries of the array have the same contents. You 
could do it by brute force, by calling Random.nextInt until it produces a value that is 
not yet in the array. Instead, you should implement a smart method. Make a second 
array and fill it with the numbers 1 to 10. Then pick one of those at random, remove 
it, and append it to the permutation array. Repeat 10 times. Implement a class 
PermutationGenerator with a method 


int{] nextPermutation 


Exercise P7.10. Add a method getWinner to the TicTacToe class of Section 7.6. It 
should return "x" or "o" to indicate a winner, or " " if there is no winner yet. Recall 
that a winning position has three matching marks in a row, column, or diagonal. 


Exercise P7.11. Write an application that plays tic-tac-toe. Your program should 
draw the game board, change players after every successful move, and pronounce 
the winner. 


Exercise P7.12. Magic squares. Ann Xn matrix that is filled with the numbers 1, 2, 
3,...,77 is a magic square if the sum of the elements in each row, in each column, 
and in the two diagonals is the same value. For example, 


Write a program that reads in n” values from the keyboard and tests whether they 
form a magic square when arranged as a square matrix. You need to test three 
features: 


2 numbers for some n? 


2 


e Did the user enter 7 


© Do each of the numbers 1, 2,..., 2“ occur exactly once in the user input? 


¢ When the numbers are put into a square, are the sums of the rows, columns, 
and diagonals equal to each other? 


If the size of the input is a square, test whether all numbers between 1 and n? are 
present. Then compute the row, column, and diagonal sums. Implement a class 
Square with methods 


public void addCint 1) 
public boolean isMagic() 


Exercise P7.13. Implement the following algorithm to construct magic n-by-n* 
squares; it works only if 7 is odd. Place a 1 in the middle of the bottom row. After k 
has been placed in the (:, 7) square, place k + 1 into the square to the right and down, 
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wrapping around the borders. However, if the square to the right and down has 
already been filled, or if you are in the lower-right corner, then you must move to 
the square straight up instead. Here is the 5 x 5 square that you get if you follow 
this method: 


18 25 Be 


7 94 1 Ra 


Write a program whose input is the number 7 and whose output is the magic square 
of order 7 if is odd. Implement a class MagicSquare with a constructor that con- 
structs the square and a toString method that returns a representation of the square. 


Exercise P7.14. Implement a class Cloud that contains an array list of Point2D.Double 
objects. Support methods 


public void add(Point2D.Double aPoint) 
public void draw(Graphics2D g2) 


Draw each point as a tiny circle. 


Write a graphical application that draws a cloud of 100 random points. 


Exercise P7.15. Implement a class Polygon that contains an array list of 
Point2D.Double objects. Support methods 


public void add(Point2D.Double aPoint) 
public void draw(Graphics2D g2) 


Draw the polygon by joining adjacent points with a line, and then closing it up by 
joining the end and start points. 


Write a graphical application that draws a square and a pentagon using two Polygon 
objects. 


Exercise P7.16. Write a class Chart with methods 


public void add(int value) 
public void draw(Graphics2D g2) 


that displays a stick chart of the added values, like this: 


You may assume that the values are pixel positions. 
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Exercise P7.17. Write a class BarChart with methods 


public void add(double value) 
public void draw(Graphics2D g2) 


that displays a chart of the added values. You may assume that all values in data are 
positive. Stretch the bars so that they fill the entire area of the screen. You must fig- 
ure out the maximum of the values, and then scale each bar. 


Exercise P7.18. Improve the BarChart class of Exercise P7.17 to work correctly when 
the data contains negative values. 


Exercise P7.19. Write a class PieChart with methods 


public void add(double value) 
public void draw(Graphics2D g2) 


that displays a pie chart of the values in data. You may assume that all data values 
are positive. 


Additional programming exercises are available in WileyPLUS. 


Project 7.1. Poker Simulator. In this assignment, you will implement a simulation of 
a popular casino game usually called video poker. The card deck contains 52 cards, 
13 of each suit. At the beginning of the game, the deck is shuffled. You need to 
devise a fair method for shuffling. (It does not have to be efficient.) Then the top 
five cards of the deck are presented to the player. The player can reject none, some, 
or all of the cards. The rejected cards are replaced from the top of the deck. Now 
the hand is scored. Your program should pronounce it to be one of the following: 


e No pair—The lowest hand, containing five separate cards that do not match 
up to create any of the hands below. 


e One pair—Two cards of the same value, for example two queens. 
e Two pairs—Two pairs, for example two queens and two 5’s. 
e Three of a kind—Three cards of the same value, for example three queens. 


e Straight—Five cards with consecutive values, not necessarily of the same suit, 
such as 4, 5, 6, 7, and 8. The ace can either precede a 2 or follow a king. 


e Flush—Five cards, not necessarily in order, of the same suit. 
¢ Full House—Three of a kind and a pair, for example three queens and two 5’s 
e Four of a Kind—Four cards of the same value, such as four queens. 


e Straight Flush—A straight and a flush: Five cards with consecutive values of 
the same suit. 


¢ Royal Flush—The best possible hand in poker. A 10, jack, queen, king, and 


ace, all of the same suit. 
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If you are so inclined, you can implement a wager. The player pays a JavaDollar for 
each game, and wins according to the following payout chart: 


Hand Payout Hand Payout 
Royal Flush 250 Straight 4 
Straight Flush 50 Three of a Kind v8 
Four of a Kind 25 Two Pair e 2 
Full House 6 Pair of Jacks or Better 1 


Flush 5 


kk Project 7.2. The Game of Life is a well-known mathematical game that gives rise to 
amazingly complex behavior, although it can be specified by a few simple rules. (It 
is not actually a game in the traditional sense, with players competing for a win.) 
Here are the rules. The game is played on a rectangular board. Each square can be 
either empty or occupied. At the beginning, you can specify empty and occupied 
cells in some way; then the game runs automatically. In each generation, the next 
generation is computed. A new cell is born on an empty square if it is surrounded 
by exactly three occupied neighbor cells. A cell dies of overcrowding if it is sur- 
rounded by four or more neighbors, and it dies of loneliness if it is surrounded by 
zero or one neighbor. A neighbor is an occupant of an adjacent square to the left, 
right, top, or bottom or in a diagonal direction. Figure 13 shows a cell and its neigh- 
bor cells. 


Many configurations show interesting behavior when subjected to these rules. 
Figure 14 shows a glider, observed over five generations. Note how it moves. After 
four generations, it is transformed into the identical shape, but located one square 
to the right and below. 


One of the more amazing configurations is the glider gun: a complex collection of 
cells that, after 30 moves, turns back into itself and a glider (see Figure 15). 


Generation 0 Generation 1 Generation 2. Generation 3. Generation 4 


Figure 13 Figure 14 
Neighborhood of a Cell in Glider 
the Game of Life 
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Figure 15 Glider Gun 


Program the game to eliminate the drudgery of computing successive generations 
by hand. Use a two-dimensional array to store the rectangular configuration. Write 
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a program that shows successive generations of the game. You may get extra credit 
if you implement a graphical application that allows the user to add or remove cells 
by clicking with the mouse. 


ANSWERS TO SELF-CHECK QUESTIONS 


. 0, 1,4, 9, 16, 25, 36, 49, 64, 81, but zot 100. 
. a. 0 


b. a run-time error: array index out of bounds 


c. a compile-time error: c is not initialized 


. new String[10]; 


new ArrayList<String>Q ; 


. names contains the strings "B" and "C" at positions 0 and 1. 

. double is one of the eight primitive types. Double is a class type. 
. data.set(O, data.get(O) + 1); 

. for (double x : data) System.out.printIn(x); 


. The loop writes a value into data[i]. The “for each” loop does not have the 


index variable i. 


. It returns the first match that it finds. 
. Yes, but the first comparison would always fail. 
. intL]£] array = new int[4][4]; 


- Int count = 0; 


for Cint i = 0; i < ROWS; i++) 
for Cint j = 0; j < COLUMNS; j++) 
if Cboard[i][j].equals¢C" ")) count++; 


. Use the add and remove methods. 


. Allocating a new array and copying the elements is time-consuming. You 


wouldn’t want to go through the process every time you add an element. 


. It is possible to introduce errors when modifying code. 
. Add a test case to the test suite that verifies that the error is fixed. 


. There is no human user who would see the prompts because input is provided 


from a file. 
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Designing 
Classes 


© To learn how to choose appropriate classes to EME “ 
© To understand the concepts of cohesion and coupling 
© To minimize the use of side effects 


_ © To document the responsibilities of methods and their callers 
with preconditions and postconditions 


: ® To understand t the difference between instance > methods and 


o introduce t! he co rcept 0 of static feds 
e ‘To. Gnderciand the scope rules for local variables ae 
instance fields 


® To learn about packages 


T To learn about unit testing frameworks 


In this chapter you will learn more about designing classes. First, we will discuss the 
process of discovering classes and defining methods. Next, we will discuss how the 
concepts of pre- and postconditions enable you to specify, implement, and invoke 
methods correctly. You will also learn about several more technical issues, such as 
static methods and variables. Finally, you will see how to use packages to organize 


your classes. 
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You have used a good number of classes in the preceding chapters and probably 
designed a few classes yourself as part of your programming assignments. Design- 
ing a class can be a challenge—it is not always easy to tell how to start or whether 


the result is of good quality. 


Students who have prior experience with programming in another programming 
language are used to programming functions. A function carries out an action. In 
object-oriented programming, the actions appear as methods. Each method, how- 
ever, belongs to a class. Classes are collections of objects, and objects are not 
actions —they are entities. So you have to start the programming activity by identi- 
fying objects and the classes to which they belong. 

Remember the rule of thumb from Chapter 2: Class names should be nouns, and 


method names should be verbs. 

What makes a good class? Most importantly, a class should repre- 
sent a single concept. Some of the classes that you have seen represent 
concepts from mathematics: 


© Point 


® Ellipse 


® Rectangle 
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Other classes are abstractions of real-life entities. 


@ BankAccount 
® CashRegister 


For these classes, the properties of a typical object are easy to understand. A 
Rectangle object has a width and height. Given a BankAccount object, you can 
deposit and withdraw money. Generally, concepts from the part of the universe that 
a program concerns, such as science, business, or a game, make good classes. The 
name for such a class should be a noun that describes the concept. Some of the stan- 
dard Java class names are a bit strange, such as Ellipse2D.Double, but you can 
choose better names for your own classes. 

Another useful category of classes can be described as actors. Objects of an actor 
class do some kinds of work for you. Examples of actors are the Scanner class of 
Chapter 4 and the Random class in Chapter 6. A Scanner object scans a stream for 
numbers and strings. A Random object generates random numbers. It is a good idea 
to choose class names for actors that end in “-er” or “-or”. (A better name for the 
Random class might be RandomNumberGenerator.) 

Very occasionally, a class has no objects, but it contains a collection of related 
static methods and constants. The Math class is a typical example. Such a class is 
called a utility class. 

Finally, you have seen classes with only a main method. Their sole purpose is to 
start a program. From a design perspective, these are somewhat degenerate exam- 
ples of classes. 

What might not be a good class? If you can’t tell from the class name what an 
object of the class is supposed to do, then you are probably not on the right track. 
For example, your homework assignment might ask you to write a program that 
prints paychecks. Suppose you start by trying to design a class PaycheckProgram. 
What would an object of this class do? An object of this class would have to do 
everything that the homework needs to do. That doesn’t simplify anything. A bet- 
ter class would be Paycheck. Then your program can manipulate one or more 
Paycheck objects. 

Another common mistake, particularly by students who are used to writing pro- 
grams that consist of functions, is to turn an action into a class. For example, if your 
homework assignment is to compute a paycheck, you may consider writing a class 
ComputePaycheck. But can you visualize a “ComputePaycheck” object? The fact that 

“ComputePaycheck” isn’t a noun tips you off that you are on the wrong track. On 
the other hand, a Paycheck class makes intuitive sense. The word “paycheck” is a 
noun. You can visualize a paycheck object. You can then think about useful meth- 
ods of the Paycheck class, such as computeTaxes, that help you solve the assignment. 


SELF CHECK 


1. What is the rule of thumb for finding classes? 


2. Your job is to write a program that plays chess. Might ChessBoard be an 
appropriate class? How about MovePiece? 
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In this section you will learn two useful criteria for analyzing the quality of the 
public interface of a class. 

A class should represent a single concept. The public methods and 
constants that the public interface exposes should be cohesive. That 
is, all interface features should be closely related to the single concept 
that the class represents. 

If you find that the public interface of a class refers to multiple 
concepts, then that is a good sign that it may be time to use separate 
classes instead. Consider, for example, the public interface of the 
CashRegister class in Chapter 4: 


public class CashRegister 


{ 
public void enterPayment(int dollars, int quarters, 
int dimes, int nickels, int pennies) 
public static final double NICKEL_VALUE = 0.05; 
public static final double DIME VALUE = 0.1; 
public static final double QUARTER _VALUE = 0.25; 
} 


There are really two concepts here: a cash register that holds coins and computes 
their total, and the values of individual coins. (For simplicity, we assume that the 
cash register only holds coins, not bills. Exercise P8.1 discusses a more general 
solution.) 

It makes sense to have a separate Coin class and have coins responsible for know- 
ing their values. 


public class Coin 


: 
public Coin(double aValue, String aName) { ... } 


public double getValue() {.. . } 


Figure 1 
Dependency Relationship Between 
the CashRegister and Coin Classes 
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Then the CashRegister class can be simplified: 


public class CashRegister 


{ 


public void enterPayment(int coinCount, Coin coinType) { .. . } 


} 


Now the CashRegister class no longer needs to know anything about coin values. 
The same class can equally well handle euros or zorkmids! 

This is clearly a better solution, because it separates the responsibilities of the 
cash register and the coins. The only reason we didn’t follow this approach in 
ois ei 4 was to keep the CashRegister example simple. 

eee Many classes need other classes in order to do their jobs. For 
example, the restructured CashRegister class now depends on the 
Coin class to determine the value of the payment. 

To visualize relationships, such as dependence between classes, 
programmers draw class diagrams. In this book, we use the UML 
(“Unified Modeling Language”) notation for objects and classes. UML is a notation 
for object-oriented analysis and design invented by Grady Booch, Ivar Jacobson, 
and James Rumbaugh, three leading researchers in object-oriented software devel- 
opment. The UML notation distinguishes between object diagrams and class dia- 
grams. In an object diagram the class names are underlined; in a class diagram the 
class names are not underlined. In a class diagram, you denote dependency by a 
dashed line with a_ -shaped open arrow tip that points to the dependent class. 
Figure 1 shows a class diagram indicating that the CashRegister class depends on the 
Coin class. 

Note that the Coin class does not depend on the CashRegister class. Coins have 
no idea that they are being collected in cash registers, and they can carry out their 
work without ever calling any method in the CashRegister class. 

If many classes of a program depend on each other, then we say that the coupling 
between classes is high. Conversely, if there are few dependencies between classes, 
then we say that the coupling is low (see Figure 2). 
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Figure 2 High and Low Coupling Between Classes 
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Why does coupling matter? If the Coin class changes in the next 
release of the program, all the classes that depend on it may be 
affected. If the change is drastic, the coupled classes must all be 
updated. Furthermore, if we would like to use a class in another pro- 
gram, we have to take with it all the classes on which it depends. 
Thus, we want to remove unnecessary coupling between classes. 


SELF CHECK 


3. Why is the CashRegister class from Chapter 4 not cohesive? 
4. Why does the Coin class not depend on the CashRegister class? 


5. Why should coupling be minimized between classes? 


QUALITY TIP 8.1 
Consistency 


In this section you learned of two criteria to analyze the quality of the public interface of a 
class. You should maximize cohesion and remove unnecessary coupling. There is another 
criterion that we would like you to pay attention to—consistency. When you have a set of 
methods, follow a consistent scheme for their names and parameters. This is simply a sign of 
good craftsmanship. 

Sadly, you can find any number of inconsistencies in the standard library. Here is an 
example. To show an input dialog box, you call 


JOptionPane.showInputDialog(promptString) 
To show a message dialog box, you call 
JOptionPane.showMessageDialog(null, messageString) 


What’s the nu11 parameter? It turns out that the showMessageDialog method needs a parame- 
ter to specify the parent window, or null if no parent window is required. But the 
showInputDialog method requires no parent window. Why the inconsistency? There is no 
reason. It would have been an easy matter to supply a showMessageDialog method that 
exactly mirrors the showInputDialog method. 

Inconsistencies such as these are not a fatal flaw, but they are an annoyance, particularly 
because they can be so easily avoided. 
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8.3 Accessors, Mutators, and 


Recall that a mutator method modifies the object on which it is invoked, whereas an 
accessor method merely accesses information without making any modifications. 
For example, in the BankAccount class, the deposit and withdraw methods are muta- 
tor methods. Calling 


account.deposit(1000) ; 
modifies the state of the account object, but calling 
double balance = account.getBalance(); 


does not modify the state of account. 

You can call an accessor method as many times as you like—you 
always get the same answer, and it does not change the state of your 
object. That is clearly a desirable property, because it makes the 
behavior of such a method very predictable. Some classes have been 
designed to have only accessor methods and no mutator methods at all. Such classes 
are called immutable. An example is the String class. Once a string has been con- 
structed, its contents never change. No method in the String class can modify the 
contents of a string. For example, the toUpperCase method does not change charac- 
ters from the original string. Instead, it constructs a mew string that contains the 
uppercase characters: 


String name = "John Q. Public"; 
String uppercased = name.toUpperCase(); // name is not changed 


An immutable class has a major advantage: It is safe to give out references to its 
objects freely. If no method can change the object’s value, then no code can modify 
the object at an unexpected time. In contrast, if you give out a BankAccount reference 
to any other method, you have to be aware that the state of your object may 
change—the other method can call the deposit and withdraw methods on the refer- 
ence that you gave it. 


SELF CHECK 


6. Is the substring method of the String class an accessor or a mutator? 


7. Is the Rectangle class immutable? 


A mutator method modifies the object on which it is invoked, whereas an accessor 
method leaves it unchanged. This classification relates only to the object on which 
the method is invoked. 
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odie A side effect of a method is any kind of modification of data that is 
any externally @ecenaple observable outside the method. Mutator methods have a side effect, 
data modification. = Ss namely the modification of the implicit parameter. 
z Here is an example of a method with another kind of side effect, 
the updating of an explicit parameter: 


public class BankAccount 


i 
Transfers money from this account to another account. 
@param amount the amount of money to transfer 
@param other the account into which to transfer the money 
public void transfer(double amount, BankAccount other) 
{ 
balance = balance - amount; 
other.balance = other.balance + amount; 
} 
} 


As a rule of thumb, updating an explicit parameter can be surprising 
a E ~~: to programmers, and it is best to avoid it whenever possible. 
effects that go beyond 
See Another example of a side effect is output. Consider how we have 
modification of the | ae | sted beanie tal 
implicit parameter, -—l ways printed a bank balance: 


You should minimize side 


System.out.printInC"The balance is now $" 
+ momsSavings.getBalance()); 


Why don’t we simply have a printBalance method? 


public void printBalance() // Not recommended 


{ 
} 


System.out.printInC"The balance is now $" + balance); 


That would be more convenient when you actually want to print the value. But, of 
course, there are cases when you want the value for some other purpose. Thus, you 
can’t simply drop the getBalance method in favor of printBalance. 

More importantly, the printBalance method forces strong assumptions on the 
BankAccount class. 


e The message is in English—you assume that the user of your software reads 
English. The majority of people on the planet don’t. 


e You rely on System.out. A method that relies on System.out won’t work in an 
embedded system, such as the computer inside an automatic teller machine. 


In other words, this design violates the rule of minimizing the coupling of the 
classes. The printBalance method couples the BankAccount class with the System 
and PrintStream classes. It is best to decouple input/output from the actual work of 
your classes. 
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SELF CHECK 


8. Ifa refers to a bank account, then the call a.deposit(100) modifies the bank 
account object. Is that a side effect? 


9. Consider the DataSet class of Chapter 6. Suppose we add a method 


void read(Scanner in) 
{ 
while Cin. hasNextDouble() ) 
add(in.nextDouble()); 
} 


Does this method have a side effect other than mutating the data set? 


COMMON ERROR 8.1 


Trying to Modify Primitive Type Parameters 


Methods can’t update parameters of primitive type (numbers, char, and boolean). To illus- 
trate this point, let us try to write a method that updates a number parameter: 


public class BankAccount 


- 
[x 
‘Transfers money from this account and tries to add it to a balance. 
@param amount the amount of money to transfer 
@param otherBalance balance to add the amount to 
af 
void transfer(double amount, double otherBalance) 2) 
if 
balance = balance - amount; 
otherBalance = otherBalance + amount; 
// Won't work 
} 
is 


This doesn’t work. Let’s consider a method call. 


double savingsBalance = 1000; 
harrysChecking.transfer(500, savingsBalance); qe 
System.out.println(savingsBalance) ; 


As the method starts, the parameter variable otherBalance is 


_ In Java, amethod can set to the same value as savingsBalance. Then the value of 
never change parameters —_— the otherBalance value is modified, but that modification has 
‘of primitive type. no effect on savingsBalance, because otherBalance is a sepa- 


rate variable (see Figure 3). When the method terminates, the 
otherBalance variable dies, and savingsBalance isn’t increased. 
Why did the example at the beginning of Section 8.4 work, where the second explicit 
parameter was a BankAccount reference? Then the parameter variable contained a copy of the 
object reference. Through that reference, the method is able to modify the object. 
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Figure 3 Modifying a Numeric Parameter Has No Effect on Caller 


You already saw this difference between objects and primitive types in Chapter 2. As a 
consequence, a Java method can never modify numbers that are passed to it. 
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QUALITY TIP 8.2 
Minimize Side Effects 


In an ideal world, all methods would be accessors that simply return an answer without 
changing any value at all. (In fact, programs that are written in so-called functional program- 
ming languages, such as Scheme and ML, come close to this ideal.) Of course, in an object- 
oriented programming language, we use objects to remember state changes. Therefore, a 
method that just changes the state of its implicit parameter is certainly acceptable. Although 
side effects cannot be completely eliminated, they can be the cause of surprises and problems 
and should be minimized. Here is a classification of method behavior. 


¢ Accessor methods with no changes to any explicit parameters—no side effects. Example: 
getBalance. 


¢ Mutator methods with no changes to any explicit parameters—an acceptable side effect. 
Example: withdraw. 


e Methods that change an explicit parameter—a side effect that should be avoided when 
possible. Example: transfer. 


e Methods that change another object (such as System. out) —a side effect that should be 
avoided. Example: printBalance. 


QUALITY TIP 8.3 
Don’t Change the Contents of Parameter Variables 


As explained in Common Error 8.1 and Advanced Topic 8.1, a method can treat its parame- 
ter variables like any other local variables and change their contents. However, that change 
affects only the parameter variable within the method itself —not any values supplied in the 
method call. Some programmers take “advantage” of the temporary nature of the parameter 
variables and use them as “convenient” holders for intermediate results, as in this example: 


public void deposit(double amount) 


{ 
// Using the parameter variable to hold an intermediate value 
amount = balance + amount; // Poor style 


} 


That code would produce errors if another statement in the method referred to amount 
expecting it to be the value of the parameter, and it will confuse later programmers maintain- 
ing this method. You should always treat the parameter variables as if they were constants. 
Don’t assign new values to them. Instead, introduce a new local variable. 


public void deposit(double amount) 


{ 


double newBalance = balance + amount; 
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ADVANCED TOPIC 8.1 


Call by Value and Call by Reference 


In Java, method parameters are copied into the parameter variables when a method starts. 
Computer scientists call this call mechanism “call by value”. There are some limitations to 
the “call by value” mechanism. As you saw in Common Error 8.1, it is not possible to 
implement methods that modify the contents of number variables. Other programming lan- 
guages such as C++ support an alternate mechanism, called “call by reference”. For example, 
in C++ it would be an easy matter to write a method that modifies a number, by using a so- 
called reference parameter. Here is the C++ code, for those of you who know C++: 


// This is C++ 


class BankAccount 


{ 
public: 
void transfer(double amount, double& otherBalance) 
// otherBalance is a double&, a reference to a double 
1 
balance = balance - amount; 
otherBalance = otherBalance + amount; // Works in C++ 
} 
be 


You will sometimes read in Java books that “numbers are passed by value, objects are passed 
by reference”. That is technically not quite correct. In Java, objects themselves are never 
passed as parameters; instead, both numbers and object references are copied by value. To see 
this clearly, let us consider another scenario. This method tries to set the otherAccount 
parameter to a new object: 


public class BankAccount 


{ 
public void transfer(double amount, BankAccount otherAccount) 
a: 
balance = balance - amount; 
double newBalance = otherAccount.balance + amount; 
otherAccount = new BankAccount(newBalance); // Won’t work 
} 
} 


In this situation, we are not trying to change the state of the 
object to which the parameter variable otherAccount refers; 
instead, we are trying to replace the object with a different 
one (see Modifying an Object Reference Parameter Has No 
Effect on the Caller). Now the parameter variable other- 
Account is replaced with a reference to a new account. But if 
you call the method with 


harrysChecking.transfer(500, savingsAccount) ; 


then that change does not affect the savingsAccount variable that is supplied in the call. 
As you can see, a Java method can update an object’s state, but it cannot replace the con- 
tents of an object reference. This shows that object references are passed by value in Java. 
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no effect on 
SavingsAccount 


Modifying an Object Reference Parameter Has No Effect on the Caller 


A precondition is a requirement that the caller of a method must 
obey. For example, the deposit method of the BankAccount class has a 
precondition that the amount to be deposited should not be negative. 
It is the responsibility of the caller never to call a method if one of its 
preconditions is violated. If the method is called anyway, it 1s not 
responsible for producing a correct result. 

Therefore, a precondition is an important part of the method, and 
you must document it. Here we document the precondition that the 
amount parameter must not be negative. 

[we 

Deposits money into this account. 


@param amount the amount of money to deposit 
(Precondition: amount >= 0) 


* / 
Some javadoc extensions support a @precondition or @requires tag, but it is not a 
part of the standard javadoc program. Because the standard javadoc tool skips all 
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unknown tags, we simply add the precondition to the method explanation or the 
appropriate @param tag. 
Preconditions are typically provided for one of two reasons: 


1. To restrict the parameters of a method 
2. To require that a method is only called when it is in the appropriate state 


For example, once a Scanner has run out of input, it is no longer legal to call the next 
method. Thus, a precondition for the next method is that the hasNext method returns 
true. 

A method 1s responsible for operating correctly only when its caller has fulfilled 
all preconditions. The method is free to do anything if a precondition is not ful- 
filled. It would be perfectly legal if the method reformatted the hard disk every time 
it was called with a wrong input. Naturally, that isn’t reasonable. What should a 
method actually do when it is called with inappropriate inputs? For example, what 
should account.deposit(-1000) do? There are two choices. 


1. A method can check for the violation and throw an exception. Then the method 
does not return to its caller; instead, control is transferred to an exception han- 
dler. If no handler is present, then the program terminates. We will discuss 
exceptions in Chapter 11. 


2. A method can skip the check and work under the assumption that the precon- 
ditions are fulfilled. If they aren’t, then any data corruption (such as a negative 
balance) or other failures are the caller’s fault. 


The first approach can be inefficient, particularly if the same check is carried out 
many times by several methods. The second approach can be dangerous. The asser- 
tion mechanism was invented to give you the best of both approaches. 

7 An assertion 1s a condition that you believe to be true at all times 
in a particular program location. An assertion check tests whether an 
assertion is true. Here is a typical assertion check that tests a 
precondition: 


public double deposit (double amount) 
{ 


assert amount >= 0; 
balance = balance + amount; 


} 


In this method, the programmer expects that the quantity amount can never be nega- 
tive. When the assertion is correct, no harm is done, and the program works in the 
normal way. If, for some reason, the assertion fails, and assertion checking is 
enabled, then the program terminates with an AssertionError. 

However, if assertion checking is disabled, then the assertion is never checked, 
and the program runs at full speed. By default, assertion checking is disabled when 
you execute a program. To execute a program with assertion checking turned on, 
use this command: 


java -enableassertions MyProg 
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SYNTAX 8.1 Assertion 


assert condition; 


Example: 


assert amount >= 0; 


Purpose: 


To assert that a condition is fulfilled. If assertion checking is enabled and the condition 1s 
false, an assertion error is thrown. 


You can also use the shortcut -ea instead of -enableassertions. You definitely want 
to turn assertion checking on during program development and testing. 

You don’t have to use assertions for checking preconditions—throwing an 
exception is another reasonable option. But assertions have one advantage: You can 
turn them off after you have tested your program, so that it runs at maximum 
speed. That way, you never have to feel bad about putting lots of assertions into 
your code. You can also use assertions for checking conditions other than 
preconditions. 

Many beginning programmers think that it isn’t “nice” to abort the program 
when a precondition is violated. Why not simply return to the caller instead? 


public void deposit(double amount) 


{ 
if Camount < Q) 
return; // Not recommended 
balance = balance + amount; 
} 


That is legal—after all, a method can do anything if its preconditions are violated. 
But it is not as good as an assertion check. If the program calling the deposit 
method has a few bugs that cause it to pass a negative amount as an input value, then 
the version that generates an assertion failure will make the bugs very obvious dur- 
ing testing —it is hard to ignore when the program aborts. The quiet version, on the 
other hand, will not alert you, and you may not notice that it performs some wrong 
calculations as a consequence. Think of assertions as the “tough love” approach to 
precondition checking. 

When a method is called in accordance with its preconditions, 
then the method promises to do its job correctly. A different kind of 
promise that the method makes 1s wile a postcondition. There are 
two kinds of postconditions: 


1. The return value is computed correctly. 


2. The object is in a certain state after the method call is completed. 
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Here is a postcondition that makes a statement about the object state after the 
deposit method is called. 


Deposits money into this account. 
(Postcondition: getBalance() >= 0) 

@param amount the amount of money to deposit 
(Precondition: amount >= 0) 

oy 
As long as the precondition is fulfilled, this method guarantees that the balance after 
the deposit is not negative. 

Some javadoc extensions support a @postcondition or @ensures tag. However, 
just as with preconditions, we simply add postconditions to the method explanation 
or the @return tag, because the standard javadoc program skips all tags that it 
doesn’t know. 

Some programmers feel that they must specify a postcondition for every method. 
When you use javadoc, however, you already specify a part of the postcondition in 
the @return tag, and you shouldn’t repeat it in a postcondition. 


// This postcondition statement is overly repetitive. 
( Returns the current balance of this account. 
@return the account balance 
(Postcondition: The return value equals the account balance.) 

a 4 
Note that we formulate pre- and postconditions only in terms of the interface of the 
class. Thus, we state the precondition of the withdraw method as amount <= 
getBalance(), not amount <=balance. After all, the caller, which needs to check the 
precondition, has access only to the public interface, not the private implementation. 

Bertrand Meyer [1] compares preconditions and postconditions to contracts. In 
real life, contracts spell out the obligations of the contracting parties. For example, 
your mechanic may promise to fix the brakes of your car, and you promise in turn 
to pay a certain amount of money. If either party breaks the promise, then the other 
is not bound by the terms of the contract. In the same fashion, pre- and postcondi- 
tions are contractual terms between a method and its caller. The method promises 
to fulfill the postcondition for all inputs that fulfill the precondition. The caller 
promises never to call the method with illegal inputs. If the caller fulfills its promise 
and gets a wrong answer, it can take the method to “programmer’s court”. If the 
caller doesn’t fulfill its promise and something terrible happens as a consequence, it 
has no recourse. 


SELF CHECK 


10. Why might you want to add a precondition to a method that you provide for 
other programmers? 


11. When you implement a method with a precondition and you notice that the 
caller did not fulfill the precondition, do you have to notify the caller? 
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ADVANCED TOPIC 8.2 


Class Invariants 


Advanced Topic 6.5 introduced the concept of loop invariants. A loop invariant is estab- 
lished when the loop is first entered, and it is preserved by all loop iterations. We then know 
that the loop invariant must be true when the loop exits, and we can use that information to 
reason about the correctness of a loop. 

Class invariants fulfill a similar purpose. A class invariant is a statement about an object 
that is true after every constructor and that is preserved by every mutator (provided that the 
caller respects all preconditions). We then know that the class invariant must always be true, 
and we can use that information to reason about the correctness of our program. 

Here is a simple example. Consider a BankAccount class with the following preconditions 
for the constructor and the mutators: 


public class BankAccount 
{ 
[ee 
Constructs a bank account with a given balance. 
@param initialBalance the initial balance 
(Precondition: initialBalance >= 0) 
ay 
public BankAccount(double initialBalance) { .. . } 
{ 


balance = initialBalance; 


Deposits money into the bank account. 
@param amount the amount to deposit 
(Precondition: amount >= 0) 

a 

public void deposit(double amount) { .. . } 


/* W 
Withdraws money from the bank account. 
@param amount the amount to withdraw 
(Precondition: amount <= getBalance()) 


* Va 
public void withdraw(double amount) { .. . } 


} 
Now we can formulate the following invariant: 


getBalance() >= 0 


To see why this invariant is true, first check the constructor; because the precondition of the 
constructor Is 


initialBalance >= 0 


we can prove that the invariant is true after the constructor has set balance to 
initialBalance. 
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Next, check the mutators. The precondition of the deposit method is 
amount >= 0 


We can assume that the invariant condition holds before calling the method. Thus, we know 
that balance >= 0 before the method executes. The laws of mathematics tell us that the sum 
of two nonnegative numbers is again nonnegative, so we can conclude that balance >= 0 
after the completion of the deposit. Thus, the deposit method preserves the invariant. 

A similar argument shows that the withdraw method preserves the invariant. 

Because the invariant is a property of the class, you document it with the class 
description: 


/* * 
A bank account has a balance that can be changed by 
deposits and withdrawals. 
(Invariant: getBalance() >= 0) 

* / 

public class BankAccount 

{ 

} 


A static method is not 
invoked on an ob 


Sometimes you need a method that is not invoked on an object. Such 
a method is called a static method or a class method. In contrast, the 
methods that you wrote up to now are often called instance methods 
because they operate on a particular instance of an object. 

A typical example of a static method is the sqrt method in the Math class. When 
you call Math. sqrt(x), you don’t supply any implicit parameter. (Recall that Math is 
the name of a class, not an object.) 

Why would you want to write a method that does not operate on an object? The 
most common reason is that you want to encapsulate some computation that 
involves only numbers. Because numbers aren’t objects, you can’t invoke methods 
on them. For example, the call x. sqrt can never be legal in Java. 

Here is a typical example of a static method that carries out some simple algebra: 
to compute p percent of the amount a. Because the parameters are numbers, the 
method doesn’t operate on any objects at all, so we make it into a static method: 

[ee 

Computes a percentage of an amount. 

@param p the percentage to apply 

@param a the amount to which the percentage is applied 
@return p percent of a 

7 

public static double percentOf(double p, double a) 

{ 


} 


return (p / 100) * a; 
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You need to find a home for this method. Let us come up with a new class (similar 
to the Math class of the standard Java library). Because the percentOf method has to 
do with financial calculations, we’ll design a class Financial to hold it. Here is the 
class: 


public class Financial 


{ 
public static double percentOf(double p, double a) 
{ 
return (p / 100) * a; 
} 
// More financial methods can be added here. 
} 


When calling a static method, you supply the name of the class containing the 
method so that the compiler can find it. For example, 


double tax = Financial.percentOf(taxRate, total); 


Note that you do not supply an object of type Financial when you call the method. 

Now we can tell you why the main method is static. When the program starts, 
there aren’t any objects. Therefore, the first method in the program must be a static 
method. 

You may well wonder why these methods are called static. The normal meaning 
of the word static (“staying fixed at one place”) does not seem to have anything to 
do with what static methods do. Indeed, it’s used by accident. Java uses the static 
keyword because C++ uses it in the same context. C++ uses static to denote class 
methods because the inventors of C++ did not want to invent another keyword. 
Someone noted that there was a relatively rarely used keyword, static, that denotes 
certain variables that stay in a fixed location for multiple method calls. (Java does 
not have this feature, nor does it need it.) It turned out that the keyword could be 
reused to denote class methods without confusing the compiler. The fact that it can 
confuse humans was apparently not a big concern. You'll just have to live with the 
fact that “static method” means “class method”: a method that does not operate on 
an object and that has only explicit parameters. 


SELF CHECK 


12. Suppose Java had no static methods. Then all methods of the Math class would 
be instance methods. How would you compute the square root of x? 


13. Harry turns in his homework assignment, a program that plays tic-tac-toe. His 
solution consists of a single class with many static methods. Why is this not an 
object-oriented solution? 
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Sometimes, you need to store values outside any particular object. You use static 
fields tor this purpose. Here is a typical example. We will use a version of our 
BankAccount class in which each bank account object has both a balance and an 
account number: 


public class BankAccount 


{ 


private double balance; 
private int accountNumber; 


} 
We want to assign account numbers sequentially. That is, we want the bank account 
constructor to construct the first account with number 1001, the next with number 
1002, and so on. Therefore, we must store the last assigned account number 
somewhere. 

It makes no sense, though, to make this value into an instance field: 


public class BankAccount 


{ 

private double balance; 

private int accountNumber; 

private int lastAssignedNumber = 1000; // NO—won’t work 
} 


In that case each instance of the BankAccount class would have its own value of 
lastAssignedNumber. 

Instead, we need to have a single value of lastAssignedNumber that 
is the same for the entire class. Such a field is called a static field, 
because you declare it using the static keyword. 


object of the class. 
public class BankAccount 


{ 

private double balance; 

private int accountNumber; 

private static int lastAssignedNumber = 1000; 
i 


Every BankAccount object has its own balance and accountNumber instance fields, but 
there is only a single copy of the lastAssignedNumber variable (see Figure 4). That 
field is stored ina separate location, outside any BankAccount objects. 

A static field is sometimes called a class field because there is a single field for the 
entire class. 

Every method of a class can access its static fields. Here is the constructor of the 
BankAccount class, which increments the last assigned number and then uses it to ini- 
tialize the account number of the object to be constructed: 


public class BankAccount 


{ 
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public BankAccount() 


{ 
// Generates next account number to be assigned 
lastAssignedNumber++; // Updates the static field 
// Assigns field to account number of this bank account 
accountNumber = lastAssignedNumber; // Sets the instance field 
} 


} 
How do you initialize a static field? You can’t set it in the class constructor: 


public BankAccount() 


{ 
lastAssignedNumber = 1000; // NO—would reset to 1000 for each new object 


} 


Then the initialization would occur each time a new instance is constructed. 


Each 
BankAccount 
object has its own 


accountNumber 
field 


There is a single 
lastAssignedNumber 
field for the 
BankAccount 
class 


Figure 4 A Static Field and Instance Fields 
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There are three ways to initialize a static field: 


1. Do nothing. The static field is then initialized with 0 (for numbers), false (for 
boolean values), or nu11 (for objects). 


2. Use an explicit initializer, such as 


public class BankAccount 


{ 


private static int lastAssignedNumber = 1000; 
} 


The initialization is executed once when the class is loaded. 
3. Use a static initialization block (see Advanced Topic 8.3). 


Like instance fields, static fields should always be declared as private to ensure that 
methods of other classes do not change their values. The exception to this rule are 
static constants, which may be either private or public. For example, the BankAccount 
class may want to define a public constant value, such as 


public class BankAccount 


{ 


public static final double OVERDRAFT_FEE = 5; 
} 


Methods from any class refer to such a constant as BankAccount .OVERDRAFT_FEE. 

It makes sense to declare constants as static—you wouldn’t want every object 
of the BankAccount class to have its own set of variables with these constant values. It 
is sufficient to have one set of them for the class. 

Why are class variables called static? As with static methods, the static key- 
word itself is just a meaningless holdover from C++. But static fields and static 
methods have much in common: They apply to the entire class, not to specific 
instances of the class. 

In general, you want to minimize the use of static methods and fields. If you find 
yourself using lots of static methods, then that’s an indication that you may not 
have found the right classes to solve your problem in an object-oriented way. 


SELF CHECK 


14. Name two static fields of the System class. 


15. Harry tells you that he has found a great way to avoid those pesky objects: Put 
all code into a single class and declare all methods and fields static. Then main 
can call the other static methods, and all of them can access the static fields. Will 
Harry’s plan work? Is it a good idea? 
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ADVANCED TOPIC 8.3 


Alternative Forms of Field Initialization 


As you have seen, instance fields are initialized with a default value (0, false, or null, 
depending on their type). You can then set them to any desired value in a constructor, and 
that is the style that we prefer in this book. 

However, there are two other mechanisms to specify an initial value for a field. Just as 
with local variables, you can specify initialization values for fields. For example, 


public class Coin 


{ 


private double value = 1; 
private String name = "Dollar"; 


} 


These default values are used for every object that is being constructed. 

There is also another, much less common, syntax. You can place one or more mitialization 
blocks inside the class definition. All statements in that block are executed whenever an 
object is being constructed. Here is an example: 


public class Coin 


{ 
{ 
value = 1; 
name = "Dollar"; 
} 
private double value; 
private String name; 
} 


For static fields, you use a static initialization block: 


public class BankAccount 


{ 
private static int lastAssignedNumber ; 
static 
{ 
TastAssignedNumber = 1000; 
} 
} 


All statements in the static initialization block are executed once when the class is loaded. 
Initialization blocks are rarely used in practice. 

When an object is constructed, the initializers and initialization blocks are executed in the 
order in which they appear. Then the code in the constructor is executed. Because the rules 
for the alternative initialization mechanisms are somewhat complex, we recommend that you 
simply use constructors to do the job of construction. 


358 CHAPTER 8 #® Designing Classes 


ariables 


When you have multiple variables or fields with the same name, 
the region ofa program in __ there 1s the possibility of conflict. In order to understand the poten- 
which the variable canbe tial problems, you need to know about the scope of each variable: the 
UOeeassad part of the program in which the variable can be accessed. 

, _ The scope of a local variable extends from the point of its declara- 

tion to the end of the block that encloses it. 

It sometimes happens that the same variable name is used in two methods. Con- 

sider the variables r in the following example: 


The scope of a variable iS. 


public class RectangleTester 


{ 
public static double area(Rectangle rect) 
| 
double r = rect.getWidth() * rect.getHeight(); 
return r; 
} 
public static void main(String[] args) 
{ 
Rectangle r = new Rectangle(5, 10, 20, 30); 
double a = area(r); 
System.out.printIn(r); 
} 
} 


These variables are independent from each other, or, in other words, their scopes are 
disjoint. You can have local variables with the same name r in different methods, 
just as you can have different motels with the same name “Bates Motel” in different 
cities. 
: ene In Java, the scope of a local variable can never contain the defini- 
The scope ofalocal = tion of another local variable with the same name. For example, the 


_ variable earner canta. following is an error: 
_ the defin 
- variable v Rectangle r = new Rectangle(5, 10, 20, 30); 
if (x >= 0) 

{ 


double r = Math.sqrt(x); 
// Error—can’t declare another variable called r here 


} 


However, you can have local variables with identical names if their scopes do not 
overlap, such as 
if (x S= 0) 


{ 
double r = Math.saqrt(x); 
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} // Scope of r ends here 


else 


{ 


Rectangle r = new Rectangle(5, 10, 20, 30); 
// OK—it is legal to declare another r here 


In this section, we consider the scope of fields and methods of a class. 
(These are collectively called the members of the class.) Private mem- 
bers have class scope: You can access all members in any of the meth- 
ods of the class. 

If you want to use a public field or method outside its class, you 
must qualify the name. You qualify a static field or method by spec- 
ifying the class name, such as Math. sqrt or Math.PI. You qualify an 
instance field or method by specifying the object to which the field 
or method should be applied, such as harrysChecking.getBalance(). 

Inside a method, you don’t need to qualify fields or methods that 
belong to the same class. Instance fields automatically refer to the 
implicit parameter of the method, that is, the object on which the 
method is invoked. For example, consider the transfer method: 


public class BankAccount 


{ 
public void transfer(double amount, BankAccount other) 
{ 
balance = balance - amount; // 1.e., this.balance 
other.balance = other.balance + amount; 
} 
} 


Here, the unqualified name balance means this.balance. (Recall from Chapter 3 
that this is a reference to the implicit parameter of any method.) 

The same rule applies to methods. Thus, another implementation of the transfer 
method is 


public class BankAccount 


f 
public void transfer(double amount, BankAccount other) 
{ 
withdrawCamount); // 1.e., this.withdrawCamount) ; 
other.deposit (amount) ; 
} 
} 


Whenever you see an instance method call without an implicit parameter, then the 
method is called on the this parameter. Such a method call is called a “self-call”. 
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Similarly, you can use a static field or method of the same class without a quali- 
fer. For example, consider the following version of the withdraw method: 


public class BankAccount 


{ 
public void withdraw(double amount) 
{ 
1f (balance < amount) balance = balance - OVERDRAFT FEE: 
else . 
} 
private static double OVERDRAFT FEE = 5; 
| 


Here, the unqualified name OVERDRAFT_FEE refers to BankAccount .OVERDRAFT_FEE. 


Problems arise if you have two identical variable names with overlapping scope. 
This can never occur with local variables, but the scopes of identically named local 
variables and instance fields can overlap. Here is a purposefully bad example. 


public class Coin 


{ 
public double getExchangeValue(double exchangeRate) 
{ 
double value; // Local variable 
return value; 
} 
private String name; 
private double value; // Field with the same name 
} 


: Inside the getExchangeValue method, the variable name value could 
A local variable can _ potentially have two meanings: the local variable or the instance 
| sheagowe a Ted ae field. The Java language specifies that in this situation the local vari- 
ae iaheanel q able wins out. It shadows the instance field. This sounds pretty arbi- 

fing it with tary, but there is actually a good reason: You can still refer to the 
instance field as this. value. 


value = this.value * exchangeRate; 


It isn’t necessary to write code like this. You can easily change the name of the local 
variable to something else, such as result. 

However, you should be aware of one common use of the this reference. When 
implementing constructors, many programmers find it tiresome to come up with 
different names for instance fields and parameters. Using the this reference solves 
that problem. Here is a typical example. 


public Coin(double value, String name) 


{ 
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this.value = value; 
this.name = name; 


i 


The expression this.value refers to the instance field, but value is the parameter. Of 
course, you can always rename the construction parameters to aValue and aName, as 
we have done in this book. 


SELF CHECK 


16. Consider the deposit method of the BankAccount class. What is the scope of the 
variables amount and newBalance? 


17. What is the scope of the balance field of the BankAccount class? 


COMMON ERROR 8.2 


Shadowing 


Accidentally using the same name for a local variable and an instance field is a surprisingly 
common error. As you saw in the preceding section, the local variable then shadows the 
instance field. Even though you may have meant to access the instance field, the local vari- 
able is quietly accessed. For some reason, this problem is most common in constructors. 
Look at this example of an incorrect constructor: 


public class Coin 


1 
public Coin(double aValue, String aName) 
{ 
value = aValue; 
String name = aName; // Oops . 
} 
private double value; 
private String name; 
i 


The programmer declared a local variable name in the constructor. In all likelihood, that was 
just a typo—the programmer’s fingers were on autopilot and typed the keyword String, 
even though the programmer all the time intended to access the instance field. Untortu- 
nately, the compiler gives no warning in this situation and quietly sets the local variable to 
the value of aName. The instance field of the object that is being constructed is never touched, 
and remains null. Some programmers give all instance field names a special prefix to distin- 
euish them from other variables. A common convention is to prefix all instance field names 
with the prefix my, such as myValue or myName. 
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PRODUCTIVITY HINT 8.1 
Global Search and Replace 


Suppose you chose an unfortunate name for a method —say perc instead of percentOf—and 
you regret your choice. Of course, you can locate all occurrences of perc in your code and 
replace them manually. However, most programming editors have a command to search for 
the perc’s automatically and replace them with percentOf. 

You need to specify some details about the search: 


¢ Do you want it to ignore case? That is, should Perc be a match? In Java you usually don’t 
want that. 


e Do you want it to match whole words only? If not, the perc in superconductor is also a 
match. In Java you usually want to match whole words. 


¢ Is this a regular-expression search? No, but regular expressions can make searches even 
more powerful—see Productivity Hint 8.2. 


¢ Do you want to confirm each replace, or simply go ahead and replace all matches? I usu- 
ally confirm the first three or four, and when I see that it works as expected, I give the go- 
ahead to replace the rest. (By the way, a global replace means to replace all occurrences in 
the document.) Good text editors can undo a global replace that has gone awry. Find out 
whether yours will. 


¢ Do you want the search to go from the point where the cursor is in the file through to the 
rest of the file, or should it search the currently selected text? Restricting replacement to a 
portion of the file can be very useful, but in this example you would want to move the 
cursor to the top of the file and then replace until the end of the file. 


Not every editor has all these options. You should investigate what your editor offers. 


PRODUCTIVITY HINT 8.2 


Regular Expressions 


Regular expressions describe character patterns. For example, numbers have a simple form. 
They contain one or more digits. The regular expression describing numbers is [0-9]+. The 
set [0-9] denotes any digit between 0 and 9, and the + means “one or more”. 

What good is it? Several utility programs use regular expressions to locate matching text. 
Also, the search commands of some programming editors understand regular expressions. 
The most popular program that uses regular expressions is grep (which stands for “global 
regular expression print”). You can run grep from a command prompt or from inside some 
compilation environments. Grep is part of the UNIX operating system, but versions are 
available for Windows and MacOS. It needs a regular expression and one or more files to 
search. When grep runs, it displays a set of lines that match the regular expression. 

Suppose you want to look for all magic numbers (see Quality Tip 4.1) in a file. The 
command 


grep [0-9]+ Homework.java 
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lists all lines in the file Homework. java that contain sequences of digits. That isn’t terribly use- 
ful; lines with variable names x1 will be listed. OK, you want sequences of digits that do not 
immediately follow letters: 


grep [AA-Za-z][0-9]+ Homework. java 


The set [AA-Za-z] denotes any characters that are not in the ranges A to Z and a to z. This 
works much better, and it shows only lines that contain actual numbers. 

For more information on regular expressions, consult one of the many tutorials on the 
Internet (such as [2]). 


ADVANCED TOPIC 8.4 


Static Imports 


Starting with Java version 5.0, there is a variant of the import directive that lets you use static 
methods and fields without class prefixes. For example, 


import static java. lang.System.*; 
import static java.lang.Math.*; 


public class RootTester 


{ 
public static void main(String[] args) 
t 
double r = sqrt(PI) // Instead of Math.sqrt (Math. PI) 
out.printin(r); // Instead of System. out 
} 
} 


Static imports can make programs easier to read, particularly if they use many mathematical 
functions. 


A Java program consists of a collection of classes. So far, most of 
your programs have consisted of a small number of classes. As pro- 
grams get larger, however, simply distributing the classes over multi- 
ple files isn’t enough. An additional structuring mechanism is needed. 
In Java, packages provide this structuring mechanism. A Java package is a set of 


related classes. For example, the Java library consists of dozens of packages, some of 
which are listed in Table 1. 
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Table 1 Important Packages in the Java Library 


Package Purpose Sample Class 
java. lang Language support Math 
java.uti] Utilities Random 

java.io Input and output PrintStream 
java.awt Abstract Windowing Toolkit Color 

java.applet Applets Applet 
java.net Networking Socket 
java.sql] Database access through Structured Query Language ResultSet 
javax.swing Swing user interface JButton 
omg.org. CORBA Common Object Request Broker Architecture for IntHolder 


distributed objects 


To put classes in a package, you must place a line 
package packageName; 


as the first instruction in the source file containing the classes. A package name con- 
sists of one or more identifiers separated by periods. (See Section 8.9.3 for tips on 
constructing package names.) 

For example, let’s put the Financial class introduced in this chapter into a pack- 
age named com.horstmann.bigjava. The Financial. java file must start as follows: 


package com.horstmann.bigjava; 


public class Financial 


{ 
} 


SYNTAX 8.2 Package Specification 


package packageName; 


Example: 


package com.horstmann.bigjava; 


Purpose: 


To declare that all classes in this file belong to a particular package 
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In addition to the named packages (such as java.util or com.horstmann.bigjava), 
there is a special package, called the default package, which has no name. If you did 
not include any package statement at the top of your source file, its classes are 
placed in the default package. 


If you want to use a class from a package, you can refer to it by its full name (pack- 
age name plus class name). For example, java.util.Scanner refers to the Scanner 
class in the java.util package: 


java.util.Scanner in = new java.util.Scanner(System. in) ; 


Naturally, that is somewhat inconvenient. You can instead import a 
name with an import statement: 


import java.util.Scanner; 


Then you can refer to the class as Scanner without the package prefix. 
You can import all classes of a package with an import statement 
that ends in .*. For example, you can use the statement 


import java.util.*; 


to import all classes from the java.util package. That statement lets you refer to 
classes like Scanner or Random without a java.util prefix. 

However, you never need to import the classes in the java. lang package explic- 
itly. That is the package containing the most basic Java classes, such as Math and 
Object. These classes are always available to you. In effect, an automatic import 
java. lang.*; statement has been placed into every source file. 

Finally, you don’t need to import other classes in the same package. For example, 
when you implement the class homework1. Tester, you don’t need to import the class 
homework1.Bank. The compiler will find the Bank class without an import statement 
because it is located in the same package, homework1. 


8.9.3 Package Names 


Placing related classes into a package is clearly a convenient mechanism to organize 
classes. However, there is a more important reason for packages: to avoid name 
clashes. Ina large project, it is inevitable that two people will come up with the same 
name for the same concept. This even happens in the standard Java class library 
(which has now grown to thousands of classes). There is a class Timer in the 
java.util package and another class called Timer in the javax.swing package. You 
can still tell the Java compiler exactly which Timer class you need, simply by refer- 
ring to them as java.util.Timer and javax.swing.Timer. 

Of course, for the package-naming convention to work, there must be some way 
to ensure that package names are unique. It wouldn’t be good if the car maker 
BMW placed all its Java code into the package bmw, and some other programmer 
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(perhaps Bertha M. Walters) had the same bright idea. To avoid this problem, the 
inventors of Java recommend that you use a package-naming scheme that takes 
aewanage of the uniqueness of Internet domain names. 

: For example, I have a domain name horstmann.com, and there is 
nobody else on the planet with the same domain name. (I was lucky 
that the domain name horstmann.com had not been taken by anyone 
else when I applied. If your name is Walters, you will sadly find that 
| someone else beat you to walters.com.) To get a package name, turn 
the Jomain name around to produce a package name prefix, such as com. horstmann. 

If you don’t have your own domain name, you can still create a package name 
that has a high probability of being unique by writing your e-mail address back- 
wards. For example, if Bertha Walters has an e-mail address walters@cs.sjsu.edu, 
then she can use a package name edu.sjsu.cs.walters for her own classes. 

Some instructors will want you to place each of your assignments into a separate 
package, such as homework1, homework2, and so on. The reason is again to avoid name 
collision. You can have two classes. homework1.Bank and homework2.Bank, with 


slightly different properties. 


“Use ado 
reverse t 


8.9.4 Ho 


If the Java compiler is properly set up on your system, and you use only the standard 
classes, you ordinarily need not worry about the location of class files and can safely 
skip this section. If you want to add your own packages, however, or if the compiler 
cannot locate a particular class or package, you need to understand the mechanism. 

A package is located in a subdirectory that matches the package 
name. The parts of the name between periods represent successively 
nested directories. For example, the package com.horstmann.bigjava 
would be placed in a subdirectory com/horstmann/bigjava. If the 
package is to be used only in conjunction with a single program, then 
you can place the subdirectory inside the directory holding that program’s files. For 
example, if you do your homework assignments in a base directory /home/walters, 
then you can place the class files for the com.horstmann.bigjava package into the 
directory /home/walters/com/horstmann/bigjava, as shown in Figure 5. (Here, we 
are using UNIX-style file names. Under Windows, you might use 
c:\home\walters\com\horstmann\bigjava.) 

However, if you want to place your programs into many different directories, such as 
/home/walters/hw1, /home/walters/hw2,. . ., then you probably don’t want to 
have lots of identical subdirectories /home/walters/hw1/com/horstmann/bigjava, 
/home/walters/hw2/com/horstmann/bigjava, and so on. In that case, you want to make 
a single directory with a name such as /home/walters/1ib/com/horstmann/bigjava, 
place all class files for the package in that directory, and tell the Java compiler once 
and for all how to locate the class files. 

You need to add the directories that might contain packages to the class path. In 
the preceding example, you add the /home/walters/lib directory to that class path. 
The details for doing this depend on your compilation environment; consult the 


Classes Are Located 
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Base directory 


> Path matches 
package name 
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Base Directories and 
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documentation for your compiler, or your instructor. If you use the Sun Java SDK, 
you need to set the class path. The exact command depends on the operating sys- 
tem. In UNIX, the command might be 


export CLASSPATH=/home/walters/lib:. 


This setting places both the /home/walters/lib directory and the current directory 
onto the class path. (The period denotes the current directory.) 
A typical example for Windows would be 


set CLASSPATH=c:\home\walters\1lib;. 


Note that the class path contains the base directories that may contain package 
directories. It is acommon error to place the complete package address in the class 
path. If the class path mistakenly contains /home/walters/lib/com/horstmann 
/bigjava, then the compiler will attempt to locate the com. horstmann.bigjava pack- 
age in /home/walters/1ib/com/horstmann/bigjava/com/horstmann/bigjava and won't 


find the files. 


SELF CHECK 


18. Which of the following are packages? 
a. java 

b. java.lang 

Cc. java.util 

d. java.lang.Math 


19. Is a Java program without import statements limited to using the default and 
java. lang packages? 


20. Suppose your homework assignments are located in the directory /home/me/ 
cs101 (c:\me\cs101 on Windows). Your instructor tells you to place your home- 
work into packages. In which directory do you place the class 
hw1.problem1.TicTacToeTester? 
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Confusing Dots 


In Java, the dot symbol ( . _) is used as a separator in the following situations: 
¢ Between package names (java.uti1) 

* Between package and class names (homework1. Bank) 

¢ Between class and inner class names (E11ipse2D.Doub1e) 

¢ Between class and instance variable names (Math. PT) 

* Between objects and methods (account. getBalance()) 


When you see a long chain of dot-separated names, it can be a challenge to find out which 
part is the package name, which part is the class name, which part is an instance variable 
name, and which part is a method name. Consider 


java. lang.System.out.printIn(x); 


Because print1n is followed by an opening parenthesis, it must be a method name. Therefore, 
out must be either an object or a class with a static printIn method. (Of course, we know that 
out is an object reference of type PrintStream.) Again, it is not at all clear, without context, 
whether System is another object, with a public variable out, or a class with a static variable. 
Judging from the number of pages that the Java bacuane specification [3] devotes to this 
issue, even the compiler has trouble interpreting these dot- separated sequences of strings. 

To avoid problems, it is helpful to adopt a strict coding style. If class names always start 
with an uppercase letter, and variable, method, and package names always start with a lower- 
case letter, then confusion can be avoided. 


How To 8.1 


Programming with Packages 


This How To explains in detail how to place your programs into packages. For example, 
your instructor may ask you to place each homework assignment into a separate package. 
That way, you can have classes with the same name but different implementations in separate 
packages (such as homework1. Bank and homework2 . Bank). 


Step 1. Come up with a package name. 


Your instructor may give you a package name to use, such as homework1. Or, perhaps you want 
to use a package name that is unique to you. Start with your e-mail address, written back- 
wards. For example, walters@cs.sjsu.edu becomes edu.sjsu.cs.walters. Then add a sub- 
package that describes your project or homework, such as edu.sjsu.cs.walters.homework1. 


Step 2 Pick a base directory. 


The base directory is the directory that contains the directories for your various packages, 
for example, /home/walters or c:\cs1. 
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Step 3. Make a subdirectory from the base directory that matches your package name. 


The subdirectory must be contained in your base directory. Each segment must match a seg- 
ment of the package name. For example, 


mkdir /home/walters/homework1 


If you have multiple segments, build them up one by one: 


mkdir c:\csl\edu 

mkdir c:\csl\edu\sjsu 

mkdir c:\csl\edu\sjsu\cs 

mkdir c:\csl\edu\sjsu\cs\walters 

mkdir c:\csl\edu\sjsu\cs\walters\homework1 


Step 4 Place your source files into the package subdirectory. 


For example, if your homework consists of the files Tester. java and Bank. java, then you 
place them into 


/home/walters/homework1/Tester.java 
/home/walters/homework1/Bank. java 


or 
c:\csl\edu\sjsu\cs\walters\homework1\Tester. java 
c:\csl\edu\sjsu\cs\walters\homework1\Bank. java 


Step 5 Use the package statement in each source file. 


The first noncomment line of each file must be a package statement that lists the name of the 
package, such as 


package homework1; 


or 
package edu.sjsu.cs.walters.homework1; 


Step 6 Compile your source files from the base directory. 


Change to the base directory (from Step 2) to compile your files. For example, 


cd /home/walters 
javac homework1/Tester. java 


or 
cd \csl 
javac edu\sjsu\cs\walters\homework1\Tester. java 


Note that the Java compiler needs the source file name and not the class name. That is, you 
need to supply file separators (/ on UNIX, \ on Windows) and a file extension (. java). 


Step 7 Run your program from the base directory. 


Unlike the Java compiler, the Java interpreter needs the class name (and not a file name) of 
the class containing the main method. That is, use periods as package separators, and don’t use 
a file extension. For example, 


cd /home/walters 
java homework1.Tester 
or 
cd \csl 
java edu.sjsu.cs.walters.homeworkl.Tester 
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RANDOM FACT 8.1 


The Explosive Growth of Personal Computers 


In 1971, Marcian E. “Ted” Hoff, an engineer at Intel Corporation, was working on a chip for 
a manufacturer of electronic calculators. He realized that it would be a better idea to develop 
a general-purpose chip that could be programmed to interface with the keys and display of a 
calculator, rather than to do yet another custom design. Thus, the microprocessor was born. 
At the time, its primary application was as a controller for calculators, washing machines, 
and the like. It took years for the computer industry to notice that a genuine central process- 
ing unit was now available as a single chip. 

Hobbyists were the first to catch on. In 1974 the first computer kit, the Altair 8800, was 
available from MITS Electronics for about $350. The kit consisted of the microprocessor, a 
circuit board, a very small amount of memory, toggle switches, and a row of display lights. 
Purchasers had to solder and assemble it, then program it in machine language through the 
toggle switches. It was not a big hit. 

The first big hit was the Apple II. It was a real computer with a keyboard, a monitor, and 
a floppy disk drive. When it was first released, users had a $3000 machine that could play 
Space Invaders, run a primitive bookkeeping program, or let users program it in BASIC. The 
original Apple II did not even support lowercase letters, making it worthless for word pro- 
cessing. The breakthrough came in 1979 with a new spreadsheet program, VisiCalc. In a 
spreadsheet, you enter financial data and their relationships into a grid of rows and columns 
(see The VisiCalc Spreadsheet Running on an Apple II). Then you modify some of the data 
and watch in real time how the others change. For example, you can see how changing the 
mix of widgets in a manufacturing plant might affect estimated costs and profits. Middle 
managers in companies, who understood computers and were fed up with having to wait for 
hours or days to get their data runs back from the computing center, snapped up VisiCalc 
and the computer that was needed to run it. For them, the computer was a spreadsheet 
machine. 

The next big hit was the IBM Personal Computer, ever after known as the PC. It was the 
first widely available personal computer that used Intel’s 16-bit processor, the 8086, whose 
successors are still being used in personal computers today. The success of the PC was based 
not on any engineering breakthroughs but on the fact that it was easy to clone. IBM pub- 
lished specifications for plug-in cards, and it went one step further. It published the exact 
source code of the so-called BIOS (Basic Input/Output System), which controls the key- 
board, monitor, ports, and disk drives and must be installed in ROM form in every PC. This 
allowed third-party vendors of plug-in cards to ensure that the BIOS code, and third-party 
extensions of it, interacted correctly with the equipment. Of course, the code itself was the 
property of IBM and could not be copied legally. Perhaps IBM did not foresee that 
functionally equivalent versions of the BIOS nevertheless could be recreated by others. 
Compaq, one of the first clone vendors, had fifteen engineers, who certified that they had 
never seen the original IBM code, write a new version that conformed precisely to the IBM 
specifications. Other companies did the same, and soon a variety of vendors were selling 
computers that ran the same software as IBM’s PC but distinguished themselves by a lower 
price, increased portability, or better performance. In time, IBM lost its dominant position in 
the PC market. It is now one of many companies producing IBM PC-compatible computers. 

IBM never produced an operating system for its PCs—that is, the software that organizes 
the interaction between the user and the computer, starts application programs, and manages 
disk storage and other resources. Instead, IBM offered customers the option of three sepa- 
rate operating systems. Most customers couldn’t care less about the operating system. They 
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The VisiCalc Spreadsheet Running on an Apple II 


chose the system that was able to launch most of the few applications that existed at the time. 
It happened to be DOS (Disk Operating System) by Microsoft. Microsoft cheerfully 
licensed the same operating system to other hardware vendors and encouraged software 
companies to write DOS applications. A huge number of useful application programs for 
PC-compatible machines was the result. 

PC applications were certainly useful, but they were not easy to learn. Every vendor 
developed a different user interface: the collection of keystrokes, menu options, and settings 
that a user needed to master to use a software package effectively. Data exchange between 
applications was difficult, because each program used a different data format. The Apple 
Macintosh changed all that in 1984. The designers of the Macintosh had the vision to supply 
an intuitive user interface with the computer and to force software developers to adhere to it. 
It took Microsoft and PC-compatible manufacturers years to catch up. 

Accidental Empires [4] is highly recommended for an amusing and irreverent account of 
the emergence of personal computers. 

At the time of this writing, it is estimated that two in three U.S. households own a per- 
sonal computer. Most personal computers are used for accessing information from online 
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sources, entertainment, word processing, and home finance (banking, budgeting, taxes). 
Some analysts predict that the personal computer will merge with the television set and cable 
network into an entertainment and information appliance. 


Up to now, we have used a very simple approach to testing. We provided tester 
classes whose main method computes values and prints actual and expected values. 
However, that approach has two limitations. It takes some time to inspect the out- 
put and decide whether a test has passed. More importantly, the main method gets 
messy if it contains many tests. 

Unit testing frameworks were designed to quickly execute and 
evaluate test suites, and to make it easy to incrementally add test 
cases. One of the most popular testing frameworks is JUnit. It is 
freely available at http://junit.org, and it is also built into a number 

_ of development environments, including Blue] and Eclipse. 
When y you use JUnit, you design a companion test class for each class that you 
develop. Two versions of JUnit are currently in common use, 3 and 4. We describe 
both versions. In JUnit 3, your test class has two essential properties: 


¢ The test class must extend the class TestCase from the junit. framework package. 


° For each test case, you must define a method whose name starts with test, such 
as testSimpleCase. 
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In each test case, you make some computations and then compute some condi- 
tion that you believe to be true. You then pass the result to a method that communi- 
cates a test result to the framework, most commonly the assertEquals method. The 
assertEquals method takes as parameters the expected and actual values and, for 
floating-point numbers, a tolerance value. 

It is also customary (but not required) that the name of the test class ends in Test, 
such as CashRegisterTest. Consider this example: 


import junit. framework.TestCase; 


public class CashRegisterTest extends TestCase 


{ 

public void testSimpleCase() 

{ 
CashRegister register = new CashRegister(); 
register.recordPurchase(0.75); 
register.recordPurchase(1.50); 
register.enterPayment(2, 0, 5, 0, 0); 
double expected = 0.25; 
assertEquals(expected, register.giveChange(), EPSILON); 

} 

public void testZeroBalance() 

‘ 
CashRegister register = new CashRegister() ; 
register.recordPurchase(2.25) ; 
register. recordPurchase(19. 25); 
register.enterPayment(21, 2, 0, 0, 0); 
assertEquals(0, register.giveChange(), EPSILON) ; 

i 

// More test cases 

private static final double EPSILON = 1E-12; 

} 


If all test cases pass, the JUnit tool shows a green bar (see Figure 6). If any of the test 
cases fail, the JUnit tool shows a red bar and an error message. 

Your test class can also have other methods (whose names should not start with 
test). These methods typically carry out steps that you want to share among test 
methods. 

JUnit 4 is even simpler. Your test class need not extend any class and you can 
freely choose names for your test methods. You use “annotations” to mark the test 
methods. An annotation is an advanced Java feature that places a marker into the 
code that is interpreted by another tool. In the case of JUnit, the @Test annotation is 
used to mark test methods. 


import org.junit.Test 
import org.junit.Assert; 


public class CashRegisterTest 


{ 
@Test public void simpleCase() 


| 
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register.recordPurchase(0.75); 

register.recordPurchase(1. 50) ; 

register.enterPayment(2, 0, 5, 0, 0); 

double expected = 0.25; 

Assert.assertEquals(expected, register.giveChange(), EPSILON) ; 


} 


// More test cases 


The JUnit philosophy is simple. Whenever you implement a class, 
also make a companion test class. You design the tests as you design 
the program, one test method at a time. The test cases just keep accu- 
| mulating in the test class. Whenever you have detected an actual failure, 
sae: a test case that flushes it out, so that you can be sure that you won’t iaiodiace 
that particular bug again. Whenever you modify your class, simply run the tests 
again. 

If all tests pass, the user interface shows a green bar and you can relax. Other- 
wise, there is a red bar, but that’s also good. It is much easier to fix a bug in isolation 
than inside a complex program. 


SELF CHECK 


21. Provide a JUnit test class with one test case for the Earthquake class in 


Chapter 5. 
22. What is the significance of the EPSILON parameter in the assertEquals method? 


CHAPTER SUMMARY 


1. A class should represent a single concept from the problem domain, such as busi- 
ness, science, or mathematics. 


2. The public interface of a class is cohesive if all of its features are related to the 
concept that the class represents. 


3. A class depends on another class if it uses objects of that class. 

4. It is a good practice to minimize the coupling (i.e., dependency) between classes. 
5. An immutable class has no mutator methods. 

6. A side effect of a method is any externally observable data modification. 


7. You should minimize side effects that go beyond modification of the implicit 
parameter. 


8. In Java, a method can never change parameters of primitive type. 
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10. 


11. 


2: 


13. 
14. 
15. 


16. 


17. 


18. 
19. 


20. 
21. 


na, 
23. 
24. 


25. 


In Java, a method can change the state of an object reference parameter, but it 
cannot replace the object reference with another. 


A precondition 1s a requirement that the caller of a method must meet. 
If a method is called in violation of a precondition, the method is not responsi- 
ble for computing the correct result. 


An assertion is a logical condition in a program that you believe to be true. 


If a method has been called in accordance with its preconditions, then it must 
ensure that its postconditions are valid. 


A static method is not invoked on an object. 
A static field belongs to the class, not to any object of the class. 


The scope of a variable is the region of a program in which the variable can be 
accessed. 


The scope of a local variable cannot contain the definition of another variable 
with the same name. 


A qualified name is prefixed by its class name or by an object reference, such as 
Math.sqrt or other.balance. 


An unqualified instance field or method name refers to the this parameter. 


A local variable can shadow a field with the same name. You can access the 
shadowed field name by qualifying it with the this reference. 


A package is a set of related classes. 


The import directive lets you refer to a class of a package by its class name, 
without the package prefix. 


Use a domain name in reverse to construct unambiguous package names. 
The path of a class file must match its package name. 


Unit test frameworks simplify the task of writing classes that contain many test 
cases. 


The JUnit philosophy is to run all tests whenever you change your code. 


FURTHER READING 


. Bertrand Meyer, Object-Oriented Software Construction, Prentice-Hall, 1989, Chapter 7. 


http: //www.zvon.org/other/PerlTutorial/Output A dynamic tutorial for regular 
expressions. . 


http://java.sun.com/docs/books/jls The Java language specification. 
Robert X. Cringely, Accidental Empires, Addison-Wesley, 1992. 
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REVIEW EXERCISES 


Exercise R8.1. Consider the following problem description: 


Users place coins in a vending machine and select a product by pushing a button. 

If the inserted coins are sufficient to cover the purchase price of the product, the 
product is dispensed and change is given. Otherwise, the inserted coins are returned 
to the user. 


What classes should you use to implement 1t? 


Exercise R8.2. Consider the following problem description: 


Employees receive their biweekly paychecks. They are paid their hourly rates for 
each hour worked; however, if they worked more than 40 hours per week, they are 
paid overtime at 150% of their regular wage. 


What classes should you use to implement it? 


Exercise R8.3. Consider the following problem description: 


Customers order products from a store. Invoices are generated to list the items and 
quantities ordered, payments received, and amounts still due. Products are shipped to 
the shipping address of the customer, and invoices are sent to the billing address. 


What classes should you use to implement it? 


Exercise R8.4, Look at the public interface of the java. 1ang.System class and discuss 
whether or not it is cohesive. 


Exercise R8.5. Suppose an Invoice object contains descriptions of the products 
ordered, and the billing and shipping address of the customer. Draw a UML 
diagram showing the dependencies between the classes Invoice, Address, Customer, 
and Product. 


Exercise R8.6. Suppose a vending machine contains products, and users insert coins 
into the vending machine to purchase products. Draw a UML diagram showing the 
dependencies between the classes VendingMachine, Coin, and Product. 


Exercise R8.7, On which classes does the class Integer in the standard library 
depend? 


Exercise R8.8. On which classes does the class Rectangle in the standard library 
depend? 


Exercise R8.9. Classify the methods of the class Scanner that are used in this book as 
accessors and mutators. 


Exercise R8.10. Classify the methods of the class Rectangle as accessors and 
mutators. 
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Exercise R8.11. Which of the following classes are immutable? 
a. Rectangle 
b. String 


c. Random 


Exercise R8.12. Which of the following classes are immutable? 
a. PrintStream 
b. Date 
c. Integer 


Exercise R8.13. What side effect, if any, do the following three methods have: 


public class Coin 


public void printQ) 
System.out.printIn(name + " " + value); 
} 
public void print(PrintStream stream) 
Sstream.printIn(name + " " + value); 
public String toStringQ 

return name + " " + value; 

} 

: a 


Exercise R8.14. Ideally, a method should have no side effects. Can you write a pro- 
gram in which no method has a side effect? Would such a program be useful? 


Exercise R8.15. Write preconditions for the following methods. Do not implement 
the methods. 
a. public static double sqrt(double x) 
b. public static String romanNumeral (int n) 
c. public static double slope(Line2D.Double a) 
d. public static String weekday(int day) 
Exercise R8.16. What preconditions do the following methods from the standard 
Java library have? 
a. Math.sqrt 
. Math.tan 
. Math. log 
. Math.exp 
. Math. pow 


>~ Oo a & o& 


Math.abs 


378 


kk 


kek 


kk 


x 


Kk 


kk 


CHAPTER 8 #® Designing Classes 


Exercise R8.17. What preconditions do the following methods from the standard Java 
library have? 


a. Integer.parseInt(String s) 

b. StringTokenizer.nextToken(Q) 
c. Random.nextIntCint n) 
d. 


String.substringCint m, int n) 


Exercise R8.18. When a method is called with parameters that violate its precondi- 
tion(s), it can terminate (by throwing an exception or an assertion error), or it can 
return to its caller. Give two examples of library methods (standard or the library 
methods used in this book) that return some result to their callers when called with 
invalid parameters, and give two examples of library methods that terminate. 


Exercise R8.19. Consider a CashRegister class with methods 

® public void enterPayment(int coinCount, Coin coinType) 

® public double getTotal Payment () 
Give a reasonable postcondition of the enterPayment method. What preconditions 
would you need so that the CashRegister class can ensure that postcondition? 
Exercise R8.20. Consider the following method that is intended to swap the values of 
two floating-point numbers: 


public static void falseSwap(double a, double b) 


{ 
double temp = a; 
a=); 
b = temp; 
} 
public static void main(String[] args) 
{ 
double x = 3; 
double y = 4; 
falseSwap(x, y); 
System.out.printIn(x + " " 4+ y); 
} 


Why doesn’t the method swap the contents of x and y? 


Exercise R8.21. How can you write a method that swaps two floating-point 
numbers? Hint: Point2D.Double. 


Exercise R8.22. Draw a memory diagram that shows why the following method can’t 
swap two BankAccount objects: 


public static void falseSwap(BankAccount a, BankAccount b) 
{ 

BankAccount temp = a; 

a=); 

b = temp; 
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Exercise R8.23. Consider an enhancement of the Die class of Chapter 6 with a static 


field 
public class Die 
{ 
public DieCint s) {.. . } 
public int castQ) {.. . } 


private int sides; 
private static Random generator = new Random(); 


} 
Draw a memory diagram that shows three dice: 


Die d4 = new Die(4); 
Die d6 = new Die(6); 
Die d8& new Die(8); 


| 


Be sure to indicate the values of the sides and generator fields. 


Exercise R8.24. Try compiling the following program. Explain the error message that 


you get. 
public class Print13 
{ 
public void print(Cint x) 
{ 
System.out.printIn(x); 
} 
public static void main(String[] args) 
{ 
me 7 = 13: 
print(n); 
} 


Exercise R8.25. Look at the methods in the Integer class. Which are static? Why? 


Exercise R8.26. Look at the methods in the String class (but ignore the ones that take 
a parameter of type char[]). Which are static? Why? 


Exercise R8.27. The in and out fields of the System class are public static fields of the 
System class. Is that good design? If not, how could you improve on it? 


Exercise R8.28. In the following class, the variable n occurs in multiple scopes. Which 
declarations of n are legal and which are illegal? 


public class X 


{ 
public int fQ 
1 
int n= 1; 
return n; 
} 


public int gCint k) 
{ 
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int a: 
for Cint n = 1; n <= k; n++) 
a=a+n; 
return a; 
li 
public int hCint n) 
{ 
Int °D: 
for Cint n = 1; n <= 10; n++) 
b=b+n:; 
return b +n; 
; 
public int k(Cint n) 
{ 
it (Hn = 0) 
{ 
int k = -n; 
int n = (int) (Math.sqrt(k)); 
return n; 
} 
else return n; 
} 
public int mCint k) 
{ 
int a; 
for Cint n= 1; n <= ks n++) 
a=atn; 
for Cint n = k; n >= 15 n++) 
a=a+tn; 
return a; 
} 


private int n; 


} 
Exercise R8.29, What is a qualified name? What is an unqualified name? 


Exercise R8.30. When you access an unqualified name in a method, what does that 
access mean? Discuss both instance and static features. 


Exercise R8.31. Every Java program can be rewritten to avoid import statements. 
Explain how, and rewrite RectangleComponent. java from Chapter 2 to avoid import 
statements. 


Exercise R8.32. What is the default package? Have you used it before this chapter in 
your programming? 


Exercise R8.33. What does JUnit do when a test method throws an exception? Try it 
out and report your findings. 


Additional review exercises are available in WileyPLUS. 
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PROGRAMMING EXERCISES 


Exercise P8.1. Implement the Coin class described in Section 8.2. Modify the 
CashRegister class so that coins can be added to the cash register, by supplying a 
method 


void enterPayment(Cint coinCount, Coin coinType) 


The caller needs to invoke this method multiple times, once for each type of coin 
that is present in the payment. 


Exercise P8.2. Modify the giveChange method of the CashRegister class so that it 
returns the number of coins of a particular type to return: 
int giveChange(Coin coinType) 


The caller needs to invoke this method for each coin type, in decreasing value. 


Exercise P8.3. Real cash registers can handle both bills and coins. Design a single 
class that expresses the commonality of these concepts. Redesign the CashRegister 
class and provide a method for entering payments that are described by your class. 
Your primary challenge is to come up with a good name for this class. 


Exercise P8.4. Enhance the BankAccount class by adding preconditions for the con- 
structor and the deposit method that require the amount parameter to be at least 
zero, and a precondition for the withdraw method that requires amount to be a value 
between 0 and the current balance. Use assertions to test the preconditions. 


Exercise P8.5. Write static methods 
@ public static double sphereVolume(Cdouble r) 
® public static double sphereSurface(double r) 
® public static double cylinderVolume(double r, double h) 
® public static double cylinderSurface(double r, double h) 
® public static double coneVolume(double r, double h) 
® public static double coneSurface(double r, double h) 


that compute the volume and surface area of a sphere with radius r, a cylinder with 
circular base with radius r and height h, and a cone with circular base with radius r 
and height h. Place them into a class Geometry. Then write a program that prompts 
the user for the values of r and h, calls the six methods, and prints the results. 


Exercise P8.6. Solve Exercise P8.5 by implementing classes Sphere, Cylinder, and 
Cone. Which approach is more object-oriented? 


Exercise P8.7. Write methods 


public static double perimeter(Ellipse2D.Double e); 

public static double area(CEllipse2D.Double e); 
that compute the area and the perimeter of the ellipse e. Add these methods to a 
class Geometry. The challenging part of this assignment is to find and implement an 
accurate formula for the perimeter. Why does it make sense to use a static method in 
this case? 
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Exercise P8.8. Write methods 
public static double angle(Point2D.Double p, Point2D.Double q) 
public static double slope(Point2D.Double p, Point2D.Double q) 


that compute the angle between the x-axis and the line joining two points, measured 
in degrees, and the slope of that line. Add the methods to the class Geometry. Supply 
suitable preconditions. Why does it make sense to use a static method in this case? 


Exercise P8.9. Write methods 


public static boolean isInside(Point2D.Double p, Ellipse2D.Double e) 
public static boolean isOnBoundary(Point2D.Double p, Ellipse2D.Double e) 
that test whether a point is inside or on the boundary of an ellipse. Add the methods 

to the class Geometry. 


Exercise P8.10. Write a method 


public static int readint( 
Scanner in, String prompt, String error, int min, int max) 
that displays the prompt string, reads an integer, and tests whether it is between the 
minimum and maximum. If not, print an error message and repeat reading the 
input. Add the method to a class Input. 


Exercise P8.11. Consider the following algorithm for computing x” for an integer 7. 
If <0, x” is 1/x”. If 2 is positive and even, then x” = (x”/?)*. If n is positive and 
odd, then x” =x”! . x. Implement a static method double intPower(double x, 

int n) that uses this algorithm. Add it to a class called Numeric. 


Exercise P8.12. Improve the Needle class of Chapter 6. Turn the generator field into a 
static field so that all needles share a single random number generator. 


Exercise P8.13. Implement a Coin and CashRegister class as described in Exercise 
P8.1. Place the classes into a package called money. Keep the CashRegisterTester class 
in the default package. 


Exercise P8.14. Place a BankAccount class in a package whose name is derived from 
your e-mail address, as described in Section 8.9. Keep the BankAccountTester class in 


the default package. 


Exercise P8.15. Provide a JUnit test class BankTest with three test methods, each of 
which tests a different method of the Bank class in Chapter 7. 


Exercise P8.16. Provide JUnit test class TaxReturnTest with three test methods that 
test different tax situations for the Tax class in Chapter 5. 
Exercise P8.17. Write methods 

® public static void drawH(Graphics2D g2, Point2D.Double p); 

® public static void drawE(Graphics2D g2, Point2D.Double p); 
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® public static void drawL(Graphics2D g2, Point2D.Double p); 
® public static void drawO0(Graphics2D g2, Point2D.Double p); 


that show the letters H, E, L, O on the graphics window, where the point p is the 
top-left corner of the letter. Then call the methods to draw the words “HELLO” 
and “HOLE” on the graphics display. Draw lines and ellipses. Do not use the 
drawString method. Do not use System. out. 


Exercise P8.18. Repeat Exercise P8.15 by designing classes LetterH, LetterE, LetterL, 
and Letter0, each with a constructor that takes a Point2D.Double parameter (the 
top-left corner) and a method draw(Graphics2D g2).Which solution is more object- 
oriented? 


Additional programming exercises are available in WileyPLUS. 


PROGRAMMING PROJECTS 


Project 8.1. Implement a program that prints paychecks for a group of student assis- 
tants. Deduct federal and Social Security taxes. (You may want to use the tax com- 
putation used in Chapter 5. Find out about Social Security taxes on the Internet.) 
Your program should prompt for the names, hourly wages, and hours worked of 
each student. 


Project 8.2. For faster sorting of letters, the United States Postal Service encourages 
companies that send large volumes of mail to use a bar code denoting the ZIP code 
(see Figure 7). 


The encoding scheme for a five-digit ZIP code is shown in Figure 8. There are 
full-height frame bars on each side. The five encoded digits are followed by a check 
digit, which is computed as follows: Add up all digits, and choose the check digit to 
make the sum a multiple of 10. For example, the sum of the digits in the ZIP code 
95014 is 19, so the check digit is 1 to make the sum equal to 20. 
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Figure 7 A Postal Bar Code Figure 8 Encoding for Five-Digit Bar Codes 
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Each digit of the ZIP code, and the check digit, is encoded according to the follow- 
ing table: 


1 0 0) 0 1 1 
2 0 0 | 0) 1 
2 0 0) 1 1 0) 
4 0 1 0) 1 


where 0 denotes a half bar and 1 a full bar. Note that they represent all combina- 
tions of two full and three half bars. The digit can be computed easily from the bar 
code using the column weights 7, 4, 2, 1, 0. For example, 01100 is 

Cede ee 20 Lae OSG 
The only exception is 0, which would yield 11 according to the weight formula. 


Write a program that asks the user for a ZIP code and prints the bar code. Use : for 
half bars, | for full bars. For example, 95014 becomes 


Vie ioe lt eee oe eee eh 
(Alternatively, write a graphical application that draws real bars.) 


Your program should also be able to carry out the opposite conversion: Translate 
bars into their ZIP code, reporting any errors in the input format or a mismatch of 


the digits. 


ANSWERS TO SELF-CHECK QUESTIONS 


1. Look for nouns in the problem description. 
2. Yes (ChessBoard) and no (MovePiece). 


3. Some of its features deal with payments, others with coin values. 
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None of the coin operations require the CashRegister class. 


If a class doesn’t depend on another, it is not affected by interface changes in the 
other class. 


It is an accessor—calling substring doesn’t modify the string on which the 
method is invoked. In fact, all methods of the String class are accessors. 


7. No—translate is a mutator. 


15. 


16, 


17. 
18. 
19. 


20. 
21. 


yy s 


It is a side effect; this kind of side effect is common in object-oriented 
programming. 
Yes—the method affects the state of the Scanner parameter. 


Then you don’t have to worry about checking for invalid values —it becomes 
the caller’s responsibility. 


No —you can take any action that is convenient for you. 


Math m = new Math(Q); y = m.sqrt(x); 


. In an object-oriented solution, the main method would construct objects of 


classes Game, Player, and the like. Most methods would be instance methods that 
depend on the state of these objects. 


| System.in and System. out. 


Yes, it works. Static methods can access static fields of the same class. But it 1s a 
terrible idea. As your programming tasks get more complex, you will want to 
use objects and classes to organize your programs. 


The scope of amount is the entire deposit method. The scope of newBalance starts 
at the point at which the variable is defined and extends to the end of the 
method. 


It starts at the beginning of the class and ends at the end of the class. 

(a) No; (b) Yes; (c) Yes; (d) No 

No—you simply use fully qualified names for all other classes, such as 
java.util.Random and java.awt.Rectangle. 

/home/me/cs101/hw1/problem1 or, on Windows, c:\me\cs101\hw1\probleml. 
Here is one possible answer, using the JUnit 4 style. 


public class EarthquakeTest 


{ 
@Test public void testLevel4() 
% 
Earthquake quake = new Earthquake(4) ; 
Assert.assertEquals("Felt by many people, no destruction", 
quake. getDescription() ); 
} 
} 


It is a tolerance threshold for comparing floating-point numbers. We want the 
equality test to pass if there is a small roundoff error. 


Interfaces and 
Polymorphism 


To learn about interfaces 

To be able to convert between class and interface references 
To understand the concept of polymorphism 

To appreciate how interfaces can be used to ) decouple aes 
To learn how to implement helper classes as inner classes 


To understand how inner r classes access variables from the a Ae 
surrounding scope : 


G To implement event listeners in graphical applications 


In order to increase programming productivity, we want to be able to reuse software 
components in multiple projects. However, some adaptations are often required to 
make reuse possible. In this chapter, you will learn an important strategy for 
separating the reusable part of a computation from the parts that vary in each reuse 
scenario. The reusable part invokes methods of an interface. It is combined with a 
class that implements the interface methods. To produce a different application, you 
simply plug in another class that implements the same methods. The program’s 
behavior varies according to the class that was plugged in—this phenomenon 1s 


called polymorphism. 


388 CHAPTERQ ® Interfaces and Polymorphism 


CHAPTER CONTENTS 


9.1 Using Interfaces for Code Reuse 388 9.6G Events, Event Sources, and Event 
SYNTAX 9.1: Defining an Interface 392 Listeners 408 

SYNTAX 9.2: Implementing an Interface 392 COMMON ERROR 9.3: Modifying the Signature in the 
COMMON ERROR 9.1: Forgetting to Define Implementing Method 411 


Implementing Methods as Public 394 


ADVANCED Topic 9.1: Constants in Interfaces 394 9.7G Using Inner Classes for 


Listeners 411 
9.2 Converting Between Class and 
Interface Types 395 
COMMON ERROR 9.2: Trying to Instantiate 
an Interface 396 


9.8G Building Applications with 
Buttons 414 
COMMON ERROR 9.4: Forgetting to Attach 
a Listener 417 
9.3 Polymorphism 396 PRODUCTIVITY HINT 9.1: Don’t Use a Container as 
9.4 Using Interfaces for Callbacks 398 are ne 
9.5 Inner Classes 403 
SYNTAX 9.3: Inner Classes 403 
ADVANCED Topic 9.2: Anonymous Classes 405 9.10G Mouse Events 421 
RANDOM FACT 9.1: Operating Systems 406 ADVANCED Topic 9.3: Event Adapters 425 
RANDOM FACT 9.2: Programming Languages 426 


9.9G Processing Timer Events 418 
COMMON ERROR 9.5: Forgetting to Repaint 421 


Use interface types to 
make code more reusable. 


It is often possible to make code more general and more reusable by 
focusing on the essential operations that are carried out. Interface 
types are used to express these common operations. 

Consider the DataSet class of Chapter 6. We used that class to 
compute the average and maximum of a set of input values. However, the class was 
suitable only for computing the average of a set of numbers. If we wanted to process 
bank accounts to find the bank account with the highest balance, we would have to 
modify the class, like this: 


public class DataSet // Modified for BankAccount objects 


{ 

public void add(BankAccount x) 

{ 
sum = sum + x.getBalance(); 
1f (count == 0 || maximum.getBalance() < x.getBalance()) 

maximum = x; 

count++; 

} 


public BankAccount getMaximum() 


{ 
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return maximum; 


} 


private double sum; 
private BankAccount maximum; 
private int count; 


} 


Or suppose we wanted to find the coin with the highest value among a set of coins. 
We would need to modify the DataSet class again. 


public class DataSet // Modified for Coin objects 
{ 


public void add(Coin x) 
{ 
sum = sum + x-getValue(); 
if (count == 0 || maximum.getValue() < x.getValueQ) 
maximum = X; 
count++; 


} 


public Coin getMaximum() 


{ 


return maximum; 


} 


private double sum; 
private Coin maximum; 
private int count; 


} 


Clearly, the fundamental mechanics of analyzing the data is the same in all cases, but 
the details of measurement differ. 

Suppose that the various classes agree on a single method getMeasure that obtains 
the measure to be used in the data analysis. For bank accounts, getMeasure returns 
the balance. For coins, getMeasure returns the coin value, and so on. Then we can 
implement a single reusable DataSet class whose add method looks like this: 


sum = sum + x.getMeasure(); 


if (count == 0 || maximum.getMeasure() < x. getMeasure()) 
maximum = X}3 
count++; 


What is the type of the variable x? Ideally, x should refer to any class that has a 
getMeasure method. | 
In Java, an interface type is used to specify required operations. 


va interface type = We will define an interface type that we call Measurable: 
sa set of methods _ 


public interface Measurable 


{ 
} 


double getMeasure() ; 
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The interface declaration lists all methods that the interface type requires. The 
Measurable interface type requires a single method, but in general, an interface type 
can require multiple methods. 

Note that the Measurable type is not a type in the standard library —it is a type 
that was created specifically for this book, in order to make the DataSet class more 


reusable. 


Unlike a class, an interface © 


type provides no 
implementation. 


An interface type is similar to a class, but there are several impor- 


tant differences: 


All methods in an interface type are abstract; that is, they have 
a name, parameters, and a return type, but they don’t have an 
implementation. 


All methods in an interface type are automatically public. 
An interface type does not have instance fields. 


Now we can use the interface type Measurable to declare the variables x and maximum. 


public class DataSet 


{ 
public void add(Measurable x) 
{ 
sum = sum + x.getMeasure(); 
1f Ccount == || maximum.getMeasure() < x.getMeasure()) 
maximum = x; 
count++; 
} 
public Measurable getMaximum() 
{ 
return maximum; 
} 
private double sum; 
private Measurable maximum; 
private int count; 
} 


Use the implements 
keyword to indicate that a 
class implements an 
interface type. | 


This DataSet class is usable for analyzing objects of any class that 
implements the Measurable interface. A class implements an interface 
type if it declares the interface in an implements clause. It should then 
implement the method or methods that the interface requires. 


class ClassName implements Measurable 


{ 
public double getMeasure() 
{ 
Implementation 
} 


Additional methods and fields 
} 
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A class can implement more than one interface type. Of course, the class must then 
define all the methods that are required by all the interfaces it implements. 
Let us modify the BankAccount class to implement the Measurab1e interface. 


public class BankAccount implements Measurable 


if 
public double getMeasure() 
{ 
return balance; 
} 
} 


Note that the class must declare the method as public, whereas the interface need 
not—all methods in an interface are public. 

Similarly, it is an easy matter to modify the Coin class to implement the 
Measurable interface. 


public class Coin implements Measurable 


{ 
public double getMeasure() 
{ 
return value; 
} 
J 


In summary, the Measurable interface expresses what all measurable objects have in 
common. This commonality makes the DataSet class reusable. Objects of the 
DataSet class can be used to analyze collections of objects of any class that imple- 
ments the Measurable interface. Following is a test program that illustrates that fact. 

Figure 1 shows the relationships between the Measurab1e interface, 
the classes that implement the interface, and the DataSet class that 
uses the interface. In the UML notation, interfaces are tagged with a 
“stereotype” indicator «interface». A dotted arrow with a triangular 


~ BankAccount Coin 


DataSet -------- «interface» 
Measurable 


Figure 1 UML Diagram of the DataSet Class and the 
Classes that Implement the Measurable Interface 
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tip denotes the “zs-a” relationship between a class and an interface. You have to 
look carefully at the arrow tips—a dotted line with an open arrow tip (>) denotes 
the “uses” relationship or dependency. 

This diagram shows that the DataSet class depends only on the Measurable inter- 
face. It is decoupled from the BankAccount and Coin classes. 


SYNTAX 9.1 Defining an Interface 


public interface InterfaceName 


{ 
method signatures 
} 
Example: 
public interface Measurable 
{ 
double getMeasure(); 
} 
Purpose: 


To define an interface and its method signatures. The methods are automatically public. 


SYNTAX 9.2 Implementing an Interface 


SRST AMER SEA SE HB EN SR A MT ET NAT EAR ST AR Tac 


public class ClassName 
implements InterfaceName, InterfaceName, .. . 


{ 
methods 
fields 
} 
Example: 
public class BankAccount implements Measurable 
{ 
// Other BankAccount methods 
public double getMeasure() 
{ 
// Method implementation 
} 
} 
Purpose: 


To define a new class that implements the methods of an interface 


9.1 


Using Interfaces for Code Reuse 


ch09/measure1 /DataSetTester.java 
1 7 wet 


won au hwWwh 


This program tests the DataSet class. 


public class DataSetTester 


{ 


public static void main(String[] args) 


{ 


Output 


Average balance: 4000.0 

Expected: 4000 

Highest balance: 10000.0 

Expected: 10000 

Average coin value: 0.13333333333333333 
Expected: 0.133 

Highest coin value: 0.25 

Expected: 0.25 


DataSet bankData = new DataSet(); 


bankData.add(new BankAccount(.))); 
bankData.add(new BankAccount(l0000)); 
bankData.add(new BankAccount(2000)); 


System.out.printInC"Average balance: " 
+ bankData.getAverage() ); 
System.out.printInC"Expected: 4000"); 
Measurable max = bankData.getMaximum() ; 
System.out.printInC"Highest balance: " 
+ max.getMeasure()) ; 
System.out.printInC"Expected: 10000"); 


DataSet coinData = new DataSet(); 


coinData.add(new Coin(0.25, “quarter")); 
coinData.add(new Coin(®.1, "“dime")); 
coinData.add(new Coin(@.05, “nickel")); 
System.out.printInC"Average coin value: " 
+ coinData.getAverage()); 
System.out.printInC"Expected: 0.133"); 
max = coinData.getMaximum() ; 
System.out.printInC"Highest coin value: ° 
+ max.getMeasure()); 
System.out.printInC"Expected: 0.25"); 


393 


394 CHAPTER #® Interfaces and Polymorphism 


SELF CHECK 


1. Suppose you want to use the DataSet class to find the Country object with the 
largest population. What condition must the Country class fulfill? 


2. Why can’t the add method of the DataSet class have a parameter of type Object? 


COMMON ERROR 9.1 
Forgetting to Define Implementing Methods as Public 


The methods in an interface are not declared as public, because they are public by default. 
However, the methods in a class are not public by default—their default access level is 
“package” access, which we discuss in Chapter 10. It is a common error to forget the public 
keyword when defining a method from an interface: 


public class BankAccount implements Measurable 


{ 
double getMeasure() // Oops—should be public 
{ 
return balance; 
; 
} 


Then the compiler complains that the method has a weaker access level, namely package 
access instead of public access. The remedy is to declare the method as public. 


ADVANCED TOPIC 9.1 


Constants in Interfaces 


Interfaces cannot have instance fields, but it is legal to specify constants. For example, the 
SwingConstants interface defines various constants, such as SwingConstants.NORTH, 
SwingConstants.EAST, and so on. 

When defining a constant in an interface, you can (and should) omit the keywords public 
static final, because all fields in an interface are automatically public static final. For 
example, 


public interface SwingConstants 
{ 

int NORTH = 1; 

int NORTHEAST = 2; 

int EAST = 3; 
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9.2 Converting Between Class and 


Interfaces are used to express the commonality between classes. In this section, we 
discuss when it is legal to convert between class and interface types. 
Have a close look at the call 


bankData.add(new BankAccount(10000) ); 


from the test program of the preceding section. Here we pass an object of type 
BankAccount to the add method of the DataSet class. However, that method has a 
parameter of type Measurable: 


public void add(Measurable x) 


Is it ee to convert from the BankAccount type to the Measurable type? 

, , In Java, such a type conversion is legal. You can convert from a 
class type to the type of any interface that the class implements. For 
example, 


o bu can conver from 


lements the interface. 2 BankAccount account = new BankAccount (10000) ; 
oe : Measurable x = account; // OK 


Alternatively, x can refer to a Coin object, provided the Coin class has been modified 
to implement the Measurable interface. 

Coin dime = new Coin(0.1, "“dime"); 

Measurable x = dime; // AlsoOK 
Thus, when you have an object variable of type Measurable, you don’t actually 
know the exact type of the object to which x refers. All you know is that the object 
has a getMeasure method. 

However, you cannot convert between unrelated types: 


Measurable x = new Rectangle(5, 10, 20, 30); // Error 


That assignment is an error, because the Rectangle class doesn’t implement the 
Measurable interface. 

Occasionally, it happens that you convert an object to an interface reference and 
you need to convert it back. This happens in the getMaximum method of the DataSet 
class. The DataSet stores the object with the largest measure, as a Measurable 
reference. 


DataSet coinData = new DataSet(); 
coinData.add(new Coin(0.25, "“quarter")); 
coinData.add(new Coin(O.1, "“dime")); 
coinData.add(new Coin(0.05, "“nickel")); 
Measurable max = coinData.getMaximum() ; 


Now what can you do with the max reference? You know it refers to a Coin object, 
but the compiler doesn’t. For example, you cannot call the getName method: 


String coinName = max.getName(); // Error 


That call is an error, because the Measurable type has no getName method. 
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However, as long as you are absolutely sure that max refers to a 


You need a cast to convert oe 
Coin object, you can use the cast notation to convert it back: 


from an interface type toa 
class type. — Coin maxCoin = (Coin) max; 
String name = maxCoin.getName() ; 
If you are wrong, and the object doesn’t actually refer to a coin, your program will 
throw an exception and terminate. 

This cast notation is the same notation that you saw in Chapter 4 to convert 
between number types. For example, if x is a floating-point number, then (int) x is 
the integer part of the number. The intent is similar—to convert from one type to 
another. However, there is one big difference between casting of number types and 
casting of class types. When casting number types, you lose information, and you 
use the cast to tell the compiler that you agree to the information loss. When casting 
object types, on the other hand, you take a risk of causing an exception, and you tell 
the compiler that you agree to that risk. 


SELF CHECK 


3. Can you use a cast (BankAccount) x to convert a Measurable variable x to a 
BankAccount reference? 


4. If both BankAccount and Coin implement the Measurable interface, can a Coin 
reference be converted to a BankAccount reference? 


COMMON ERROR 9.2 
Trying to Instantiate an Interface 


You can define variables whose type is an interface, for example: 
Measurable x; 

However, you can never construct an interface: 
Measurable x = new Measurable(); // Error 


Interfaces aren’t classes. There are no objects whose types are interfaces. If an interface vari- 
able refers to an object, then the object must belong to some class—a class that implements 
the interface: 


Measurable x = new BankAccount(); // OK 


When multiple classes implement the same interface, each class implements the 
methods of the interface in different ways. How is the correct method executed 
when the interface method is invoked? We will answer that question in this section. 
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It is worth emphasizing once again that it is perfectly legal—and in fact very 
common—to have variables whose type is an interface, such as 


Measurable x; 


Just remember that the object to which x refers doesn’t have type Measurable. In 
fact, no object has type Measurable. Instead, the type of the object is some class that 
implements the Measurable interface, such as BankAccount or Coin. 

Note that x can refer to objects of different types during its lifetime. Here the 
variable x first contains a reference to a bank account, then a reference to a coin. 


x = new BankAccount(10000); // OK 
xX = new Coin(0.1, "dime"); // OK 


What can you do with an interface variable, given that you don’t know the class of 
the object that it references? You can invoke the methods of the interface: 


double m = x.getMeasure() ; 


The DataSet class took advantage of this capability by computing the measure of the 
added object, without worrying exactly what kind of object was added. 

Now let’s think through the call to the getMeasure method more carefully. Which 
getMeasure method? The BankAccount and Coin classes provide two different imple- 
mentations of that method. How did the correct method get called if the caller 
didn’t even know the exact class to which x belongs? 

The Java virtual machine makes a special effort to locate the correct method that 
belongs to the class of the actual object. That is, if x refers to a BankAccount object, 
then the BankAccount.getMeasure method is called. If x refers to a Coin object, then 
the Coin. getMeasure method 1s called. This means that one method call 


double m = x.getMeasure(); 


can call different methods depending on the momentary contents of x. 

si The principle that the actual type of the object determines the 
method to be called is called polymorphism. The term “polymor- 
phism” comes from the Greek words for “many shapes”. The same 
computation works for objects of many shapes, and adapts itself to 
the nature of the objects. In Java, all instance methods are 
polymorphic. 

When you see a polymorphic method call, such as x. getMeasure(), there are sev- 
eral possible getMeasure methods that can be called. You have already seen another 
case in which the same method name can refer to different methods, namely when a 
method name is overloaded: that is, when a single class has several methods with the 
same name but different parameter types. For example, you can have two construc- 
tors BankAccount() and BankAccount (double). The compiler selects the appropriate 
method when compiling the program, simply by looking at the types of the 
parameters: 


hism deno 


account = new BankAccount(); 

// Compiler selects BankAccount () 
account = new BankAccount(10000) ; 

// Compiler selects BankAccount (double) 
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There is an important difference between polymorphism and over- 
loading. The compiler picks an overloaded method when translating 
the program, before the program ever runs. This method selection is 
called early binding. However, when selecting the appropriate 
getMeasure method in a call x.getMeasure(), the compiler does not 
make any decision when translating the method. The program has to 
run before anyone can know what is stored in x. Therefore, the vir- 
tual machine, and not the compiler, selects the appropriate method. 
This method selection is called late binding. 


2 program runs. = 


SELF CHECK 


5. Why is it impossible to construct a Measurable object? 
6. Why can you nevertheless declare a variable whose type is Measurable? 


7. What do overloading and polymorphism have in common? Where do they 
differ? 


In this section, we discuss how the DataSet class can be made even more reusable by 
supplying a different interface type. This type of interface provides a “callback” 
mechanism, allowing the DataSet class to call back a specific method when it needs 
note a omnaton 

To understand why a further improvement to the DataSet class is desirable, con- 
sider these limitations of the Measurab1e interface: 


e You can add the Measurable interface only to classes under your control. If you 
want to process a set of Rectangle objects, you cannot make the Rectangle class 
implement another interface —it is a system class, which you cannot change. 


e You can measure an object in only one way. If you want to analyze a set of sav- 
ings accounts both by bank balance and by interest rate, you are stuck. 


Therefore, let us rethink the DataSet class. The data set needs to measure the objects 
that are added. When the objects are required to be of type Measurable, the respon- 
sibility of measuring lies with the added objects themselves, which is the cause of 
the limitations that we noted. It would be better if another object could carry out 
the measurement. Let’s move the measurement method into a different interface: 


public interface Measurer 


{ 
$ 


The measure method measures an object and returns its measurement. Here we use 
the fact that all objects can be converted to the type Object, the “lowest common 


double measure(Object anObject); 


9.4 = Using Interfaces for Callbacks 399 


denominator” of all classes in Java. We will discuss the Object type in greater detail 
in Chapter 10. 

The improved DataSet class is constructed with a Measurer object (that is, an 
object of some class that implements the Measurer interface). That object is saved in 
a measurer instance field and used to carry out the measurements, like this: 


public void add(Object x) 


{ 
sum = sum + measurer.measure(x) ; 
if Ccount == O || measurer.measure(maximum) < measurer.measure(x) ) 
maximum = xX; 
count++; 
} 


The DataSet class simply makes a callback to the measure method whenever it needs 
to measure any object. 

Now you can define measurers to take on any kind of measurement. For exam- 
ple, here is how you can measure rectangles by area. Define a class 


public class RectangleMeasurer implements Measurer 


{ 
public double measure(Object anObject) 
t 
Rectangle aRectangle = (Rectangle) anObject; 
double area = aRectangle.getWidth() * aRectangle.getHeightQ) ; 
return area; 
} 
} 


Note that the measure method must accept a parameter of type Object, even though 
this particular measurer just wants to measure rectangles. The method signature 
must match the signature of the measure method in the Measurer interface. There- 
fore, the Object parameter is cast to the Rectangle type: 


Rectangle aRectangle = (Rectangle) anObject; 


What can you do with a RectangleMeasurer? You need it for a DataSet that compares 
rectangles by area. Construct an object of the RectangleMeasurer class and pass it to 
the DataSet constructor. 


Measurer m = new RectangleMeasurer() ; 
DataSet data = new DataSet(m); 


Next, add rectangles to the data set. 


data.add(new Rectangle(5, 10, 20, 30)); 
data.add(new Rectangle(10, 20, 30, 40)); 


The data set will ask the RectangleMeasurer object to measure the rectangles. In 
other words, the data set uses the RectangleMeasurer object to carry out callbacks. 
Figure 2 shows the UML diagram of the classes and interfaces of this solution. 
As in Figure 1, the DataSet class is decoupled from the Rectangle class whose 
objects it processes. However, unlike in Figure 1, the Rectangle class is no longer 
coupled with another class. Instead, to process rectangles, you have to come up 
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Figure 2 UML Diagram of the DataSet Class and the Measurer Interface 


with a small “helper” class RectangleMeasurer. This helper class has only one pur- 
pose: to tell the DataSet how to measure its objects. 


ch09/measure2/DataSet.java 


/* ve 


Computes the average of a set of data values. 


%* 


public class DataSet 


{ 


Constructs an empty data set with a given measurer. 


@param aMeasurer the measurer that is used to measure data values 


public DataSet(Measurer aMeasurer) 


{ 


sum = 0; 

count = 0; 

maximum = null; 
measurer = aMeasurer; 


Adds a data value to the data set. 


@param x a data value 


¥ / 
public void add(Object x) 


{ 


sum = sum + measurer.measure(x) ; 
if (count == 0 
|| measurer.measure(maximum) < measurer.measure(x) ) 
maximum = xX; 
count++ } 
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/* * 
Gets the average of the added data. | 
@return the average or 0 if no data has been added 


* / 
public double getAverage() 


{ 
if Ccount == 0) return 0; 
else return sum / count; 
} 
7 ks 


Gets the largest of the added data. | 
@return the maximum or 0 if no data has been added 


public Object getMaximum() 
{ 


} 


return maximum; 


private double sum; 
private Object maximum; 
private int count; 

private Measurer measurer; 


ch09/measure2/DataSetTester2.java 


1 import java.awt.Rectangle; 


a 


* / 


3 
4 
5 
6 public class DataSetTester2 
7 
8 


{ 


This program demonstrates the use of a Measurer. 


public static void main(String[] args) 


{ 


Measurer m = new RectangleMeasurer(); 
DataSet data = new DataSet(m) ; 


data.add(new Rectangle(5, 10, 20, 30)); 
data.add(new Rectangle(10, 20, 30, 40)); 
data.add(new Rectangle(20, 30, 5, 15)); 


System.out.printInC'Average area: " + data.getAverage()); 
System.out.printInC"Expected: 625"); 


Rectangle max = (Rectangle) data.getMaximum() ; 

System.out.printInC'"Maximum area rectangle: " + max); 

System.out.printInC"Expected: java.awt.Rectangle[ 
x=10, y=20,width=30,height=40]"); 
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ch09/measure2/Measurer.java 


1 
2 Describes any class whose objects can measure other objects. 
3 * / 
4 public interface Measurer 
> { 
6 /* ¥ 

7 Computes the measure of an object. 
8 @param anObject the object to be measured 
9 
10 
11 
12 


@return the measure 


double measure(Object anObject) ; 


ch09/measure2/RectangleMeasurer.java 


import java.awt.Rectangle; 


Objects of this class measure rectangles by area. 


1 
2 
3 
4 
5 ria 
6 public class RectangleMeasurer implements Measurer 
7 
8 
9 
10 


: 
public double measure(Object anObject) 
{ 
Rectangle aRectangle = (Rectangle) anObject; 

il. double area = aRectangle.getWidthQ) * aRectangle.getHeight() ; 
12 return area; 
13 } 
14 } 
Output 


Average area: 625 

Expected: 625 

Maximum area rectangle: java.awt.Rectangle[x=10, y=20,width=30,height=40] 
Expected: java.awt.Rectangle[x=10, y=20,width=30,height=40 ] 


SELF CHECK 


8. Suppose you want to use the DataSet class of Section 9.1 to find the longest 
String from a set of inputs. Why can’t this work? 


9. How can you use the DataSet class of this section to find the longest String 
from a set of inputs? 


10. Why does the measure method of the Measurer interface have one more parame- 
ter than the getMeasure method of the Measurable interface? 
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HL 
Artista 


The RectangleMeasurer class is a very trivial class. We need this class only because 
the DataSet class needs an object of some class that implements the Measurer inter- 
face. When you have a class that serves a very limited purpose, such as this one, you 
can declare the class inside the method that needs it: 


public class DataSetTester3 


{ 
public static void main(String[] args) 
{ 
class RectangleMeasurer implements Measurer 
{ 
} 
Measurer m = new RectangleMeasurer(); 
DataSet data = new DataSet(m) ; 
} 
} 


Such a class is called an inner class. An inner class is any class that is 
defined inside another class. This arrangement signals to the reader of 
your program that the RectangleMeasurer class is not interesting 
beyond the scope of this method. Since an inner class inside a 
method is not a publicly accessible feature, you don’t need to docu- 
ment it as thoroughly. 

ai You can also define an inner class inside an enclosing class, but 
saiside of its methods. Then the inner class is available to all methods of the enclos- 
ing class. 


SYNTAX 9.3 Inner Classes 


Declared inside a method: Declared inside the class: 
class OuterClassName class OuterClassName 
{ { 
method signature methods 
{ fields 
oo, accessSpecifier class InnerClassName 
class InnerClassName { 
f methods 
methods fields 
fields } 
} : 
} 
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Example: 
public class Tester 
t 
public static void main(String[] args) 
{ 
class RectangleMeasurer implements Measurer 
{ 
} 
} 
} 
Purpose: 


To define an inner class whose scope is restricted to a single method or the methods of a 
single class 


When you compile the source files for a program that uses inner classes, have a 
look at the class files in your program directory —you will find that the inner classes 
are stored in files with curious names, such as DataSetTester3$1$Rectangle- 
Measurer.class. The exact names aren’t important. The point is that the compiler 
turns an inner class into a regular class file. 


ch09/measure3/DataSetTester3.java 


1 import java.awt.Rectangle; 


3 eve 

4 This program demonstrates the use of an inner class. 

5 * / 

6 public class DataSetTester3 

7 { 

8 public static void main(String[] args) 

{ 

10 class RectangleMeasurer implements Measurer 
ll { 
12 public double measure(Object anObject) 
13 { 
14 Rectangle aRectangle = (Rectangle) anObject; 
15 double area 
16 = aRectangle.getWidth() * aRectangle.getHeightQ) ; 
17 return area; 
18 } 
19 } 
20 
21 Measurer m = new RectangleMeasurer() ; 
22 
23 DataSet data = new DataSet(m) ; 
24 


25 data.add(new Rectangle(5, 10, 20, 30)); 
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26 data.add(new Rectangle(i0, 20, 30, 40)); 

27 data.add(new Rectangle(20, 30, 5, 15)); 

28 

29 System.out.printInC"Average area: " + data.getAverage()); 
30 System.out.printInC"Expected: 625"); 

31 

32 Rectangle max = (Rectangle) data.getMaximum() ; 

33 System.out.printIn("Maximum area rectangle: " + max); 
34 System.out.printInC"Expected: java.awt.Rectangle[ 

35 x=10, y=20 ,width=30, height=40]"); 

36 } 

37 3} 

SELF CHECK 


11. Why would you use an inner class instead of a regular class? 


12. How many class files are produced when you compile the DataSetTester3 
program? 


ADVANCED TOPIC 9.2 


Anonymous Classes 


An entity 1s anonymous if it does not have a name. In a program, something that is only used 
once doesn’t usually need a name. For example, you can replace 


Coin aCoin = new Coin(0.1, "dime"); 
data.add(aCoin) ; 


with 
data.add(new Coin(0.1, "dime")); 


if the coin is not used elsewhere in the same method. The object new Coin(0.1, "dime") is an 
anonymous object. Programmers like anonymous objects, because they don’t have to go 
through the trouble of coming up with a name. If you have struggled with the decision 
whether to call a coin c, dime, or aCoin, you’ll understand this sentiment. 

Inner classes often give rise to a similar situation. After a single object of the Rectangle- 
Measurer has been constructed, the class is never used again. In Java, it is possible to define 
anonymous classes if all you ever need is a single object of the class. 


public static void main(String[] args) 
{ 
// Construct an object of an anonymous class 
Measurer m = new Measurer() 
// Class definition starts here 
{ 
public double measure(Object anObject) 
{ 
Rectangle aRectangle = (Rectangle) anObject; 
double area = aRectangle.getWidth() * aRectangle.getHeight(); 
return area; 


406 


CHAPTERY «8 Interfaces and Polymorphism 


x5 
DataSet data = new DataSet(m); 


} 


This means: Construct an object of a class that implements the Measurer interface by defin- 
ing the measure method as specified. Many programmers like this style, but we will not use it 


in this book. 


RANDOM FACT 9.1 


Operating Systems 


Without an operating system, a computer would not be useful. Minimally, you need an operat- 
ing system to locate files and to start programs. The programs that you run need services from 
the operating system to access devices and to interact with other programs. Operating systems 
on large computers need to provide more services than those on personal computers do. 

Here are some typical services: 


e Program loading. Every operating system provides some way of launching application 
programs. The user indicates what program should be run, usually by typing the name of 
the program or by clicking on an icon. The operating system locates the program code, 
loads it into memory, and starts 1t. 


e Managing files. A storage device, such as a hard disk is, electronically, simply a device 
capable of storing a huge sequence of zeroes and ones. It is up to the operating system to 
bring some structure to the storage layout and organize it into files, folders, and so on. 
The operating system also needs to impose some amount of security and redundancy into 
the file system so that a power outage does not jeopardize the contents of an entire hard 
disk. Some operating systems do a better job in this regard than others. 


e Virtual memory. RAM is expensive, and few computers have enough RAM to hold all 
programs and their data that a user would like to run simultaneously. Most operating sys- 
tems extend the available memory by storing some data on the hard disk. The application 
programs do not realize whether a particular data item is in memory or in the virtual 
memory disk storage. When a program accesses a data item that is currently not in RAM, 
the processor senses this and notifies the operating system. The operating system swaps 
the needed data from the hard disk into RAM, simultaneously swapping out a memory 
block of equal size that had not been accessed for some time. 


e Handling multiple users. The operating systems of large and powerful computers allow 
simultaneous access by multiple users. Each user is connected to the computer through a 
separate terminal. The operating system authenticates users by checking that each one has 
a valid account and password. It gives each user a small slice of processor time, then serves 
the next user. 


e Multitasking. Even if you are the sole user of a computer, you may want to run multiple 
applications —for example, to read your e-mail in one window and run the Java compiler 
in another. The operating system is responsible for dividing processor time between the 
applications you are running, so that each can make progress. 
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° Printing. The operating system queues up the print requests that are sent by multiple 
applications. This is necessary to make sure that the printed pages do not contain a mix- 
ture of words sent simultaneously from separate programs. 


¢ Windows. Many operating systems present their users with a desktop made up of multiple 
windows. The operating system manages the location and appearance of the window 
frames; the applications are responsible for the interiors. 


° Fonts. To render text on the screen and the printer, the shapes of characters must be 
defined. This is especially important for programs that can display multiple type styles 
and sizes. Modern operating systems contain a central font repository. 


°* Communicating between programs. The operating system can facilitate the transfer of 
information between programs. That transfer can happen through cut and paste or inter- 
process communication. Cut and paste is a user-initiated data transfer in which the user 
copies data from one application into a transfer buffer (often called a “clipboard”) man- 
aged by the operating system and inserts the buffer’s contents into another application. 
Interprocess communication is initiated by applications that transfer data without direct 
user involvement. 


e Networking. The operating system provides protocols and services for enabling applica- 
tions to reach information on other computers attached to the network. 


Today, the most popular operating systems for personal computers are Linux (see figure), the 


Macintosh OS, and Microsoft Windows. 


408 CHAPTERQ «8 Interfaces and Polymorphism GRAPHICS TRACK 


In the applications that you have written so far, user input was under control of the 
program. The program asked the user for input in a specific order. For example, 
a program might ask the user to supply first a name, then a dollar amount. But the 
programs that you use every day on your computer don’t work like that. In a pro- 
gram with a modern graphical user interface, the user is in control. The user can use 
both the mouse and the keyboard and can manipulate many parts of the user inter- 
face in any desired order. For example, the user can enter information into text 
fields, pull down menus, click buttons, and drag scroll bars in any order. The pro- 
gram must react to the user commands, in whatever order they arrive. Having to 
deal with many possible inputs in random order is quite a bit harder than simply 
forcing the user to supply input in a fixed order. 

In the following sections, you will learn how to write Java pro- 


User interface events Ba 
: ~.~———S—S—”:s grams that can react to user interface events, such as button pushes 


include key p' ae 
ide me Ne and mouse clicks. The Java windowing toolkit has a very sophisti- 
“clieke’ mani cated mechanism that allows a program to specify the events in 


which it is interested and which objects to notify when one of these 
oa ~events occurs. 

Whenever the user of a graphical program types characters or uses the mouse 
anywhere inside one of the windows of the program, the Java window manager 
sends a notification to the program that an event has occurred. The window man- 
ager generates huge numbers of events. For example, whenever the mouse moves a 
tiny interval over a window, a “mouse move” event is generated. Events are also 
generated when the user presses a key, clicks a button, or selects a menu item. 

eee Most programs don’t want to be flooded by boring events. For 
example, when a button is clicked with the mouse, the mouse moves 
over the button, then the mouse button is pressed, and finally the 
button is released. Rather than receiving lots of irrelevant mouse 
events, a program can indicate that it only cares about button clicks, 
not about the underlying mouse events. However, if the mouse input 
is used for drawing shapes on a virtual canvas, it 1s necessary to 
closely track mouse events. 

Every program must indicate which events it needs to receive. It does that by 
installing event listener objects. An event listener object belongs to a class that you 
define. The methods of your event listener classes contain the instructions that you 
want to have executed when the events occur. 

To install a listener, you need to know the event source. The event 
source is the user interface component that generates a particular 
event. You add an event listener object to the appropriate event 
sources. Whenever the event occurs, the event source calls the appro- 
priate methods of all attached event listeners. 


occurs, the eve 
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This sounds somewhat abstract, so let’s run through an extremely 


Use JButton components — 
| simple program that prints a message whenever a button is clicked. 


for buttons. Attach an 


ket oni esaner t6 each Button listeners must belong to a class that implements the Action- 
button. Listener interface: 
| public interface ActionListener 
{ 
void actionPerformed(ActionEvent event); 
} 


This particular interface has a single method, actionPerformed. It is your job to sup- 
ply a class whose actionPerformed method contains the instructions that you want 
executed whenever the button is clicked. Here is a very simple example of such a lis- 
tener class: 


ch09/button1/ClickListener.java 


import jJava.awt.event.ActionEvent; 
import jJava.awt.event.ActionListener; 


1 
2 
3 
4 
: An action listener that prints a message. 

ey 

7 public class ClickListener implements ActionListener 

8 { 

9 public void actionPerformed(ActionEvent event) 
10 
i} 
12 


{ 
} 


System.out.printInC'"I was clicked."); 


We ignore the event parameter of the actionPerformed method — it contains addi- 
tional details about the event, such as the time at which it occurred. 

Once the listener class has been defined, we need to construct an object of the 
class and add it to the button: 


ActionListener listener = new ClickListener(); 
button.addActionListener(listener); 


Whenever the button is clicked, it calls 
listener.actionPerformed(event) ; 


As a result, the message is printed. 

You can think of the actionPerformed method as another example of a callback, 
similar to the measure method of the Measurer class. The windowing toolkit calls the 
actionPerformed method whenever the button is pressed, whereas the DataSet calls 
the measure method whenever it needs to measure an object. 

You can test this program out by opening a console window, starting the Button- 
Viewer program from that console window, clicking the button, and watching the 
messages in the console window (see Figure 3). 
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Figure 3. Implementing an Action Listener 
ch09/button1 /ButtonViewer.java 
1 import java.awt.event.ActionListener; 
2 import javax.swing.JButton; 
3 import javax.swing.JFrame; 
4 
5 Paes 
6 This program demonstrates how to install an action listener. 
7 * 
8 public class ButtonViewer 
| 
10 public static void main(String[] args) 
11 
LZ JFrame frame = new JFrameQ); 
13 JButton button = new JButtonC("Click me!"); 
14 frame.add(button) ; 
15 
16 ActionListener listener = new ClickListener() ; 
17 button.addActionListener(listener) ; 
18 
19 frame.setSizeC(FRAME_WIDTH, FRAME HEIGHT) ; 
20 frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE 
21 frame.setVisible(true); 
22 
Z3 
24 private static final int FRAME_WIDTH = 100; 
25 private static final int FRAME_HEIGHT = 60; 
26 } 
SELF CHECK 
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| [Terminal 


File Edit ie Tina Tabs Help 
~$ cd BigJava/ch09/button1l 


~/BigJava/ch09/buttonl$ javac ButtonViewer. java 
~/BigJava/ch09/button1$ java ButtonViewer 


I was clicked. 
I was clicked. 
I was clicked. 


GRAPHICS TRACK 


13. Which objects are the event source and the event listener in the ButtonViewer 


program? 


14. Why is it legal to assign a ClickListener object to a variable of type 
ActionListener? 


9.7 = Using Inner Classes for Listeners GraPHics TRACK 411 


COMMON ERROR 9.3 
Modifying the Signature in the Implementing Method 


When you implement an interface, you must define each method exactly as it is specified i in 
the interface. Accidentally making small changes to the parameter or return types is a com- 
mon error. Here is the classic example, 


class MyListener implements ActionListener 


{ 
public void actionPerformed() 
// Oops . . . forgot ActionEvent parameter 
{ 
} 
; 


As far as the compiler is concerned, this class has two methods: 


public void actionPerformed(ActionEvent event) 
public void actionPerformed() 


The first method is undefined. The compiler will complain that the method is missing. You 
have to read the error message carefully and pay attention to the parameter and return types 
to find your error. 


In the preceding section, you saw how the code that is executed when a button is 
clicked is placed into a listener class. It is common to implement listener classes as 
inner classes like this: 


JButton button = new JButtonC(". . ."); 


// This inner class is declared in the same method as the button variable 
class MyListener implements ActionListener 


{ 
ie 


ActionListener listener = new MyListener(); 
button. addActionListener( listener) ; 


There are two reasons for this arrangement. First, it places the trivial listener class 
exactly where it is needed, without cluttering up the remainder of the project. 
Moreover, inner classes have a very attractive feature: Their methods can access 
variables that are defined in surrounding blocks. In this regard, method definitions 
of inner classes behave similarly to nested blocks. 
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Recall that a block is a statement group enclosed by braces. If a block is nested 
inside another, the inner block has access to all variables from the surrounding 


block: 


{ // Surrounding block 


BankAccount account = new BankAccount(); 


ane 


-) 


{ // lance block 


// OK to access variable from surrounding block 
account.deposit(Cinterest) ; 


} 7, / Bad of inner block 


+ // End of surrounding block 


Methods of an inner class - 
can access local variables” 
from surrounding blocks. 
and fields from 
surrounding classes. — 


The same nesting works for inner classes. Except for some technical 
restrictions, which we will examine later in this section, the methods 
of an inner class can access the variables from the enclosing scope. 
This feature is very useful when implementing event handlers. It 
allows the inner class to access variables without having to pass them 
as constructor or method parameters. 

Let’s look at an example. Suppose we want to add interest to a 


bank account whenever a button 1s clicked. 


JButton button = new JButtonC"Add Interest"); 
final BankAccount account = new BankAccountCINITIAL_BALANCE) ; 


// This inner class is declared in the same method as the account and button variables. 
class AddInterestListener implements ActionListener 


i 


public void actionPerformed(ActionEvent event) 


i 


// The listener method accesses the account variable 
// from the surrounding block 
double interest = account.getBalance() 


* INTEREST_RATE / 100; 


account.deposit(Cinterest) ; 


ie 


ActionListener listener = new AddInterestListener(); 
button.addActionListener(listener) ; 


Local variables that are | 
accessed by an inner-class 
method must be declared ~ 
as Tinal. 


There is a technical wrinkle. An inner class can access surrounding 
local variables only if they are declared as final. That sounds like a 
restriction, but it is usually not an issue in practice. Keep in mind that 
an object variable is final when the variable always refers to the same 
object. The state of the object can change, but the variable can’t refer 
to a different object. For example, in our program, we never intended 


to have the account variable refer to multiple bank accounts, so there was no harm 
in declaring it as final. 
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An inner class can also access fields of the surrounding class, again with a restric- 
tion. The field must belong to the object that constructed the inner class object. If 
the inner class object was created inside a static method, it can only access static sur- 
rounding fields. 

Here is the source code for the program. 


ch09/button2/InvestmentViewer1 java 


1 import java.awt.event.ActionEvent; 
2 import java.awt.event.ActionListener; 
3 import javax.swing.JButton; 
4 import javax.swing. JFrame; 
5 
5 ;* 
7 This program demonstrates how an action listener can access 
8 a variable from a surrounding block. 
o. =f 
10 public class InvestmentViewer1 
ll {f 
iz public static void main(String[] args) 
13 f 
14 JFrame frame = new JFrame(); 
15 
16 // The button to trigger the calculation 
17 JButton button = new JButton("Add Interest"); 
18 frame.add(button) ; 
19 
20 // The application adds interest to this bank account 
21 final BankAccount account = new BankAccountCINITIAL_ BALANCE) ; 
22 
23 class AddInterestListener implements ActionListener 
24 { 
25 public void actionPerformed(ActionEvent event) 
26 { 
a7 // The listener method accesses the account variable 
28 // from the surrounding block 
29 double interest = account.getBalance() 
30 * INTEREST_RATE / 100; 
31 account.deposit(Cinterest) ; 
32 System.out.printInC'balance: "“ + account.getBalance()); 
33 } 
34 } 
35 
36 ActionListener listener = new AddInterestListener(); 
37 button.addActionListener(listener) ; 
38 
39 frame.setSizeC(FRAME_ WIDTH, FRAME HEIGHT); 
40 frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
41 frame.setVisible(true); 
42 } 
43 


44 private static final double INTEREST_RATE = 10; 
45 private static final double INITIAL_BALANCE = 1000; 
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47 private static final int FRAME_WIDTH = 120; 

48 private static final int FRAME _HEIGHT = 60; 

49 } 

Output 


balance: 1100.0 
balance: 1210.0 
balance: 1331.0 
balance: 1464.1 


SELF CHECK 


15. Why would an inner class method want to access a variable from a surrounding 
scope? 


16. If an inner class accesses a local variable from a surrounding scope, what special 
rule applies? 


In this section, you will learn how to structure a graphical application that contains 
buttons. We will put a button to work in our simple investment viewer program. 
Whenever the button is clicked, interest is added to a bank account, and the new 
balance is displayed (see Figure 4). 

First, we construct an object of the JButton class. Pass the button label to the 


constructor: 
JButton button = new JButtonC("Add Interest"); 


We also need a user interface component that displays a message, namely the cur- 
rent bank balance. Such a component is called a abel. You pass the initial message 
string to the JLabel constructor, like this: 


JLabel label = new JLabelC"balance: " + account.getBalance()); 


| Add Interest | balance: 1100.0 


Figure 4 An Application with a Button 
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Usea Panel Congincrtes: The frame of our application contains both the button and the label. 


group multiple user- _ However, we cannot simply add both components directly to the 
‘interface components _ frame—they would be placed on top of each other. The solution is to 
together. put them into a panel, a container for other user-interface compo- 


nents, and then add the panel to the frame: 


JPanel panel = new JPanel(); 
panel.add(button) ; 
panel.add(label) ; 
frame.add(panel); 


Now we are ready for the hard part—the event listener that handles button clicks. 
As in the preceding section, it is necessary to define a class that implements the 
ActionListener interface, and to place the button action into the actionPerformed 
method. Our listener class adds interest and displays the new balance: 


class AddInterestListener implements ActionListener 


t 
public void actionPerformed(ActionEvent event) 
{ 
double interest = account.getBalance() * INTEREST_RATE / 100; 
account.deposit(Cinterest) ; 
label.setText("balance: " + account.getBalance()); 
Mi 
} 


There is just a minor technicality. The actionPerformed method 
manipulates the account and label variables. These are local variables 
of the main method of the investment viewer program, not instance 
fields of the AddInterestListener class. We therefore need to declare 
the account and label variables as final so that the actionPerformed 
method can access them. 

Let’s put the pieces together. 


public static void main(String[] args) 


{ 
JButton button = new JButtonC"Add Interest"); 
final BankAccount account = new BankAccountCINITIAL BALANCE) ; 
final JLabel label = new JLabelC"balance: " + account.getBalance()); 


class AddInterestListener implements ActionListener 


1 
public void actionPerformed(ActionEvent event) 
{ 
double interest = account.getBalance() 
* INTEREST _RATE / 100; 
account.deposit(Cinterest) ; 
label.setTextC"balance: " + account.getBalance()); 
} 
i 


ActionListener listener = new AddInterestListenerQ ; 
button.addActionListener( listener) ; 
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} 


With a bit of practice, you will learn to glance at this code and translate it into plain 
English: “When the button is clicked, add interest and set the label text.” 

Here is the complete program. It dencustates how toadd multiple components 
to a frame, by using a panel, and how to implement listeners as inner classes. 


ch09/button3/InvestmentViewer2.java 


1 import java.awt.event.ActionEvent; 

2 import java.awt.event.ActionListener; 
3 import javax.swing.JButton; 

4 import javax.swing.JFrame; 

5 import javax.swing.JLabel; 

6 import javax.swing. JPanel; 

7 import javax.swing.JTextField; 
8 

9 
10 
ll 


ale ale 
woes 


This program displays the growth of an investment. 


12. public class InvestmentViewer2 


13 { 

14 public static void main(String[] args) 

15 { 

16 JFrame frame = new JFrameQ); 

17 

18 // The button to trigger the calculation 

19 JButton button = new JButtonC"Add Interest"); 

20 

21 // The application adds interest to this bank account 

ae final BankAccount account = new BankAccount(INITIAL_BALANCE) ; 
23 

24 // The label for displaying the results 

25 final JLabel label = new JLabel( 

26 "balance: " + account.getBalance(Q)); 

27 

28 // The panel that holds the user interface components 
29 JPanel panel = new JPanel(); 

30 panel.add(button) ; 

31 panel.add(label); 

32 frame.add(panel); 

33 

34 class AddInterestListener implements ActionListener 
35 { 

36 public void actionPerformed(ActionEvent event) 
37 { 

38 double interest = account.getBalance() 

39 * INTEREST_RATE / 100; 

40 account.deposit(interest) ; 

41 label. setText( 

42 "balance: " + account.getBalance()); 
43 y 

aa } 
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46 ActionListener listener = new AddInterestListener(); 
47 button.addActionListener(listener) ; 

48 

49 frame.setSizeCFRAME_WIDTH, FRAME HEIGHT) ; 

50 frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
51 frame.setVisible(true); 

52 } 

a5 

54 private static final double INTEREST_RATE = 10; 

55 private static final double INITIAL_BALANCE = 1000; 

56 

57 private static final int FRAME_WIDTH = 400; 

58 private static final int FRAME_HEIGHT = 100; 

59 } 

SELF CHECK 

17. How do you place the "balance: . . ." message to the left of the "Add 


Interest" button? 


18. Why was it not necessary to declare the button variable as final? 


COMMON ERROR 9.4 


Forgetting to Attach a Listener 


If you run your program and find that your buttons seem to be dead, double-check that you 
attached the button listener. The same holds for other user interface components. It is a sur- 
prisingly common error to program the listener class and the event handler action without 
actually attaching the listener to the event source. 


PRODUCTIVITY HINT 9.1 


Don’t Use a Container as a Listener 


In this book, we use inner classes for event listeners. That approach works for many differ- 
ent event types. Once you master the technique, you don’t have to think about it anymore. 
Many development environments automatically generate code with inner classes, so it is a 
good idea to be familiar with them. 

However, some programmers bypass the event listener classes and instead turn a con- 
tainer (such as a panel or frame) into a listener. Here is a typical example. The 
actionPerformed method is added to the viewer class. That is, the viewer implements the 
ActionListener interface. 


public class InvestmentViewer 
implements ActionListener // This approach is not recommended 
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public InvestmentVi ewer () 


{ 
JButton button = new JButtonC("Add Interest"); 
button.addActionListener(this) ; 

} 

public void actionPerformed(ActionEvent event) 

{ 

} 


Now the actionPerformed method is a part of the InvestmentViewer class rather than part of 
a separate listener class. The listener is installed as this. 

This technique has two major flaws. First, it separates the button definition from the but- 
ton action. Also, it doesn’t scale well. If the viewer class contains two buttons that each gen- 
erate action events, then the actionPerformed method must investigate the event source, 
which leads to code that is tedious and error-prone. 


-Atimer generates timer 
events at fixed intervals. — 


In this section we will study timer events and show how they allow you to imple- 
ment simple animations. 

The Timer class in the javax.swing package generates a sequence of action events, 
spaced apart at even time intervals. (You can think of a timer as an invisible button 
that is automatically clicked.) This is useful whenever you want to have an object 
updated in regular intervals. For example, in an animation, you may want to update 
a scene ten times per second and redisplay the image, to give the illusion of 
movement. 

When you use a timer, you specify the frequency of the events and 
an object of a class that implements the ActionListener interface. 
Place whatever action you want to occur inside the actionPerformed 
method. Finally, start the timer. 


class MyListener implements ActionListener 


{ 
public void actionPerformed(ActionEvent event) 
{ 
// This action will be executed at each timer event 
Place listener action here 
} 
} 


MyListener listener = new MyListener(); 
Timer t = new TimerCinterval, listener); 
t.startl): 
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Then the timer calls the actionPerformed method of the listener object every 
interval milliseconds. 

Our sample program will display a moving rectangle. We first supply a Rectan- 
gleComponent class with a moveBy method that moves the rectangle by a given 
amount. 


ch09/timer/RectangleComponent.java 


1 import java.awt.Graphics; 
2 import java.awt.Graphics2D; 
3 import java.awt.Rectangle; 
4 import javax.swing.JComponent; 
5 
6 Piers 
7 This component displays a rectangle that can be moved. 
8 */ 
public class RectangleComponent extends JComponent 
10 { 
11 public RectangleComponent () 
iz 
13 // The rectangle that the paint method draws 
14 box = new Rectangle(BOX_X, BOX_Y, 
15 BOX_WIDTH, BOX_HEIGHT) ; 
16 
a7 
18 public void paintComponent(Graphics g) 
19 
20 super .paintComponent (g) ; 
21 Graphics2D g2 = (Graphics2D) g; 
22 
23 g2.draw(box) ; 
24 } 
25 
26 KI 
27 Moves the rectangle by a given amount. 
28 @param x the amount to move in the x-direction 
29 @param y the amount to move in the y-direction 
30 * 
31 public void moveByCint dx, int dy) 
32 
33 box.translate(dx, dy); 
34 repaint() ; 
35 ; 
36 
37 private Rectangle box; 
38 
39 private static final int BOX_X = 100; 
4 private static final int BOX_Y = 100; 


41 private static final int BOX_WIDTH = 20; 
42 private static final int BOX_HEIGHT = 30; 
43 
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The -épainemkihod Note the call to repaint in the moveBy method. This call is necessary 
Causes acomponentto _—«t ensure that the component is repainted after the state of the rect- 
repaint itself. Call this angle object has been changed. Keep in mind that the component 
method whenever you _ object does not contain the pixels that show the drawing. The com- 
modify the shapes thatthe | ponent merely contains a Rectangle object, which itself contains four 
paintComponent method — coordinate values. Calling translate updates the rectangle coordi- 
draws. — _ nate values. The call to repaint forces a call to the paintComponent 

_ method. The paintComponent method redraws the component, caus- 

ing the rectangle to appear at the updated location. 

The actionPerformed method of the timer listener simply calls compo- 
nent.moveBy(1, 1). This moves the rectangle one pixel down and to the right. Since 
the actionPerformed method is called many times per second, the rectangle appears 
to move smoothly across the frame. 


ch09/timer/RectangleMover.java 


1 import java.awt.event.ActionEvent; 
2 import java.awt.event.ActionListener; 
3 import javax.swing. JFrame; 
4 import javax.swing.Timer; 
5 
6 [** 
7 This program moves the rectangle. 
8 
9 public class RectangleMover 
10 { 
11 public static void main(String[] args) 
12 { 
13 JFrame frame = new JFrame(); 
14 
15 frame.setSize(FRAME_WIDTH, FRAME HEIGHT); 
16 frame.setTitle("An animated rectangle"): 
17 frame.setDefaultCloseOperation(JFrame.EXIT_ON_ CLOSE); 
18 
19 final RectangleComponent component = new RectangleComponent(); 
20 frame.add(component) ; 
21 
22 frame.setVisible(true) ; 
23 
24 class TimerListener implements ActionListener 
25 { 
26 public void actionPerformed(ActionEvent event) 
27 { 
28 component.moveBy(1, 1); 
29 } 
30 } 
31 
32 ActionListener listener = new TimerListener(); 
33 
34 final int DELAY = 100; // Milliseconds between timer ticks 
35 Timer t = new Timer(DELAY, listener); 


36 t.start(): 
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37 } 

38 

39 private static final int FRAME_WIDTH = 200; 
40 private static final int FRAME_HEIGHT = “00; 
41 } 

SELF CHECK 


19. Why does a timer require a listener object? 
20. What would happen if you omitted the call to repaint in the moveBy method? 


COMMON ERROR 9.5 
Forgetting to Repaint 


You have to be careful when your event handlers change the data in a painted component. 
When you make a change to the data, the component is not automatically painted with the 
new data. You must tell the Swing framework that the component needs to be repainted, by 
calling the repaint method either in the event handler or in the component’s mutator meth- 
ods. Your component’s paintComponent method will then be invoked at an opportune 
moment, with an appropriate Graphics object. Note that you should not call the paintCompo- 
nent method directly. 

This is a concern only for your own painted components. When you make a change to a 
standard Swing component such as a JLabel, the component is automatically repainted. 


You use a mouse listener 
to capture mouse events. 


LOLS Sate Scns 


If you write programs that show drawings, and you want users to 
manipulate the drawings with a mouse, then you need to process 
mouse events. Mouse events are more complex than button clicks 
or timer ticks. 

A mouse listener must implement the MouseListener interface, which contains 
the following five methods: 


public interface MouseListener 
{ 
void mousePressed(MouseEvent event); 
// Called when a mouse button has been pressed on a component 
void mouseReleased(MouseEvent event) ; 
// Called when a mouse button has been released on a component 
void mouseClicked(MouseEvent event) ; 
// Called when the mouse has been clicked on a component 
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void mouseEntered(MouseEvent event) ; 

// Called when the mouse enters a component 
void mouseExited(MouseEvent event); 

// Called when the mouse exits a component 


} 


The mousePressed and mouseReleased methods are called whenever a mouse button 
is pressed or released. If a button is pressed and released in quick succession, and 
the mouse has not moved, then the mouseClicked method is called as well. The 
mouseEntered and mouseExited methods can be used to paint a user-interface compo- 
nent in a special way whenever the mouse is pointing inside it. 

The most commonly used method is mousePressed. Users generally expect that 
their actions are processed as soon as the mouse button is pressed. 

You add a mouse listener to a component by calling the addMouseListener 
method: 


public class MyMouseListener implements MouseListener 


{ 
} 


// Implements five methods 


MouseListener listener = new MyMouseListener(); 
component.addMouseListener(listener) ; 


In our sample program, a user clicks on a component containing a rectangle. When- 
ever the mouse button is pressed, the rectangle is moved to the mouse location. We 
first enhance the RectangleComponent class and add a moveTo method to move the 
rectangle to a new position. 


ch09/mouse/RectangleComponent.java 
import java.awt.Graphics; 
import java.awt.Graphics2D; 
import java.awt.Rectangle; 
import javax.swing.JComponent; 


This component displays a rectangle that can be moved. 


1 
2 
3 
4 
5 
6 /* 
7 
8 
9 
10 


* / 
public class RectangleComponent extends JComponent 
{ 
11 public RectangleComponent () 
12 1 
13 // The rectangle that the paint method draws 
14 box = new Rectangle(BOX_X, BOX_Y, 
15 BOX_WIDTH, BOX _HEIGHT) ; 
16 } 
17 
18 public void paintComponent(Graphics g) 
19 if 
20 Super.paintComponent(g) ; 
21 Graphics2D g2 = (Graphics2D) g; 
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23 g2.draw(box) ; 

24 } 

25 

26 oe 

27 Moves the rectangle to the given location. 
28 @param x the x-position of the new location 
29 @param y the y-position of the new location 
30 “ 

31 public void moveTo(int x, int y) 

32 { 

33 box.setLocation(x, y); 

34 repaintQ); 

35 } 

36 

37 private Rectangle box; 

38 

39 private static final int BOX_X = 100; 

40 private static final int BOX_Y = 100; 

41 private static final int BOX_WIDTH = 20; 
42 private static final int BOX_HEIGHT = 30; 
43 } 


Note the call to repaint in the moveTo method. As explained in the preceding sec- 
tion, this call causes the component to repaint itself and show the rectangle in the 
new position. 

Now, add a mouse listener to the component. Whenever the mouse is pressed, 
the listener moves the rectangle to the mouse location. 


class MousePressListener implements MouseListener 


{ 
public void mousePressed(MouseEvent event) 
{ 
int x = event.getXxQ; 
int y = event.getY(); 
component.moveTo(x, y); 
} 
// Do-nothing methods 
public void mouseReleased(MouseEvent event) {} 
public void mouseClicked(MouseEvent event) {} 
public void mouseEntered(MouseEvent event) {} 
public void mouseExited(MouseEvent event) {} 
} 


It often happens that a particular listener specifies actions only for one or two of the 
listener methods. Nevertheless, all five methods of the interface must be imple- 
mented. The unused methods are simply implemented as do-nothing methods. 

Go ahead and run the RectangleComponentViewer program. Whenever you click 
the mouse inside the frame, the top left corner of the rectangle moves to the mouse 
pointer (see Figure 5). 
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Figure 5 Clicking the 
Mouse Moves the Rectangle 


Interfaces and Polymorphism 


ch09/mouse/RectangleComponentViewer.java 


import java.awt.event.MouseListener; 
import java.awt.event.MouseEvent; 
import javax.swing. JFrame; 


/ ke al. 


This program displays a Rectang]leComponent. 


public class RectangleComponentViewer 


public static void main(String[] args) 


{ 
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final RectangleComponent component = new RectangleComponent() ; 


// Add mouse press listener 


class MousePressListener implements MouseListener 


{ 


public void mousePressed(MouseEvent event) 


{ 


int x event.getXxQ); 
int y = event.getY(); 
component.moveTo(x, y); 


} 


// Do-nothing methods 

public void mouseReleased(MouseEvent event) {} 
public void mouseClicked(MouseEvent event) {} 
public void mouseEntered(MouseEvent event) {} 
public void mouseExited(MouseEvent event) {} 
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30 } 

31 

32 MouseListener listener = new MousePressListener(); 
33 component. addMouseListener(listener) ; 

34 

35 JFrame frame = new JFrame(); 

36 frame.add(component) ; 

37 

38 frame.setSize(FRAME_WIDTH, FRAME_HEIGHT) ; 

39 frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
40 frame.setVisible(true) ; 

41 } 

42 

43 private static final int FRAME_WIDTH = 300; 

44 private static final int FRAME_HEIGHT = 400; 

45 } 

SELF CHECK 


21. Why was the moveBy method in the RectangleComponent replaced with a moveTo 
method? 


22. Why must the MousePressListener class supply five methods? 


ADVANCED TOPIC 9.3 


Event Adapters 


In the preceding section you saw how to install a mouse listener into a mouse event source 
and how the listener methods are called when an event occurs. Usually, a program is not 
interested in all listener notifications. For example, a program may only be interested in 
mouse clicks and may not care that these mouse clicks are composed of “mouse pressed” and 
“mouse released” events. Of course, the program could supply a listener that defines all 
those methods in which it has no interest as “do-nothing” methods, for example: 


class MouseClickListener implements MouseListener 


{ 


public void mouseClicked(MouseEvent event) 


{ 


// Mouse click action here 


} 


// Four do-nothing methods 

public void mouseEntered(MouseEvent event) {} 
public void mouseExited(MouseEvent event) {} 
public void mousePressed(MouseEvent event) {} 
public void mouseReleased(MouseEvent event) {} 


} 


This is boring. For that reason, some friendly soul has created a MouseAdapter class that 
implements the MouseListener interface such that all methods do nothing. You can extend 
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that class, inheriting the do-nothing methods and overriding the methods that you care 
about, like this: 


class MouseClickListener extends MouseAdapter 


{ 
public void mouseClicked(MouseEvent event) 
{ 
// Mouse click action here 
} 
} 


See Chapter 10 for more information on the process of extending classes. 


RANDOM FACT 9.2 


Programming Languages 


Many hundreds of programming languages exist today, which is actually quite surprising. 
The idea behind a high-level programming language is to provide a medium for program- 
ming that is independent from the instruction set of a particular processor, so that one can 
move programs from one computer to another without rewriting them. Moving a program 
from one programming language to another is a difficult process, however, and it is rarely 
done. Thus, it seems that there would be little use for so many programming languages. 

Unlike human languages, programming languages are created with specific purposes. 
Some programming languages make it particularly easy to express tasks from a particular 
problem domain. Some languages specialize in database processing; others in “artificial intel- 
ligence” programs that try to infer new facts from a given base of knowledge; others in 
multimedia programming. The Pascal language was purposefully kept simple because it was 
designed as a teaching language. The C language was developed to be translated efficiently 
into fast machine code, with a minimum of housekeeping overhead. The C++ language 
builds on C by adding features for object-oriented programming. The Java language was 
designed for securely deploying programs across the Internet. 

In the early 1970s the U.S. Department of Defense (DoD) was seriously concerned about 
the high cost of the software components of its weapons equipment. It was estimated that 
more than half of the total DoD budget was spent on the development of this embedded- 
systems software—that is, software that is embedded in some machinery, such as an airplane 
or missile, to control it. One of the perceived problems was the great diversity of program- 
ming languages that were used to produce that software. Many of these languages, such as 
TACPOL, CMS-2, SPL/1, and JOVIAL, were virtually unknown outside the defense sector. 

In 1976 a committee of computer scientists and defense industry representatives was 
asked to evaluate existing programming languages. The committee was to determine whether 
any of them could be made the DoD standard for all future military programming. To 
nobody’s surprise, the committee decided that a new language would need to be created. 
Contractors were then invited to submit designs for such a new language. Of 17 initial pro- 
posals, four were chosen to develop their languages. To ensure an unbiased evaluation, the 
languages received code names: Red (by Intermetrics), Green (by CII Honeywell Bull), Blue 
(by Softech), and Yellow (by SRI International). All four languages were based on Pascal. 
The Green language emerged as the winner in 1979. It was named Ada in honor of the 
world’s first programmer, Ada Lovelace (see Random Fact 14.1). 
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The Ada language was roundly derided by academics as a typical bloated Defense Depart- 
ment product. Military contractors routinely sought, and obtained, exemptions from the 
requirement that they had to use Ada on their projects. Outside the defense industry, few 
companies used Ada. Perhaps that is unfair. Ada had been designed to be complex enough to 
be useful for many applications, whereas other, more popular languages, notably C++, have 
grown to be just as complex and ended up being unmanageable. 

The initial version of the C language was designed around 1972. Unlike Ada, C is a simple 
language that lets you program “close to the machine”. It is also quite unsafe. Because 
different compiler writers added different features, the language actually sprouted various 
dialects. Some programming instructions were understood by one compiler but rejected by 
another. Such divergence is an immense pain to a programmer who wants to move code from 
one computer to another, and an effort got underway to iron out the differences and come 
up with a standard version of C. The design process ended in 1989 with the completion of 
the ANSI (American National Standards Institute) Standard. In the meantime, Bjarne 
Stroustrup of AT&T added features of the language Simula (an object-oriented language 
designed for carrying out simulations) to C. The resulting language was called C++. From 
1985 until today, C++ has grown by the addition of many features, and a standardization 
process was completed in 1998. C++ has been enormously popular because programmers 
can take their existing C code and move it to C++ with only minimal changes. In order to 
keep compatibility with existing code, every innovation in C++ had to work around the 
existing language constructs, yielding a language that is powerful but somewhat cumbersome 
to use. 

In 1995, Java was designed to be conceptually simpler and more internally consistent than 
C++, while retaining the syntax that is familiar to millions of C and C++ programmers. The 
Java language was a great design success. It is indeed clean and simple. As for the Java 
library, you know from your own experience that it is neither. 

Keep in mind that a programming language is only part of the technology for writing 
programs. To be successful, a programming language needs feature-rich libraries, powerful 
tools, and a community of knowledgeable and enthusiastic users. Several very well-designed 
programming languages have withered on the vine, whereas other programming languages 
whose design was merely “good enough” have thrived in the marketplace. 
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CHAPTER SUMMARY 


11. 


12 


13. 


14 


15. 


16 


17. 
18. 


LiF 


Use interface types to make code more reusable. 
A Java interface type declares a set of methods and their signatures. 
Unlike a class, an interface type provides no implementation. 


Use the implements keyword to indicate that a class implements an interface 


type. 


Interfaces can reduce the coupling between classes. 


. You can convert from a class type to an interface type, provided the class 


implements the interface. 
You need a cast to convert from an interface type to a class type. 


Polymorphism denotes the principle that behavior can vary depending on the 
actual type of an object. 


Early binding of methods occurs if the compiler selects a method from several 
possible candidates. Late binding occurs if the method selection takes place 
when the program runs. 


An inner class is declared inside another class. Inner classes are commonly used 
for tactical classes that should not be visible elsewhere in a program. 


User interface events include key presses, mouse moves, button clicks, menu 
selections, and so on. 


An event listener belongs to a class that is provided by the application program- 
mer. Its methods describe the actions to be taken when an event occurs. 


Event sources report on events. When an event occurs, the event source notifies 
all event listeners. 


Use JButton components for buttons. Attach an ActionListener to each button. 


Methods of an inner class can access local variables from surrounding blocks 
and fields trom surrounding classes. 


Local variables that are accessed by an inner-class method must be declared as 
final. 


Use a JPanel container to group multiple user-interface components together. 


You often install event listeners as inner classes so that they can have access to 
the surrounding fields, methods, and final variables. 


A timer generates timer events at fixed intervals. 
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20. The repaint method causes a component to repaint itself. Call this method 
whenever you modify the shapes that the paintComponent method draws. 


21. You use a mouse listener to capture mouse events. 


CLASSES, OBJECTS, AND METHODS 
INTRODUCED IN THIS CHAPTER — 


java.awt.Component 
addMouseListener 
repaint 
java.awt.Container 
add 
java.awt.Rectangle 
setLocation 
java.awt.event.ActionListener 
actionPerformed 
java.awt.event.MouseEvent 
getx 
gety 
jJava.awt.event.MouseListener 
mouseC licked 
mouseEntered 
mouseExited 
mousePressed 
mouseRe leased 
jJavax.swing.AbstractButton 
addActionListener 
javax.swing.JButton 
javax.swing.JLabel 
javax.swing. JPanel 
jJavax. swing. Timer 
start 
stop 


REVIEW EXERCISES 


* Exercise R9.1. Suppose C is a class that implements the interfaces I and J. Which of 
the following assignments require a cast? 


Cce= : 
Iis : 
Ij = : 
aC = 1; 
b. j = C; 
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* Exercise R9.2. Suppose C is a class that implements the interfaces I and J, and sup- 
pose i is declared as 


I i = new CQ); 
Which of the following statements will throw an exception? 
aCce= () 1; 
b J j=) 1; 
& 1 = (1) null; 
* Exercise R9.3. Suppose the class Sandwich implements the Edible interface, and you 
are given the variable definitions 


Sandwich sub = new Sandwich(); 
Rectangle cerealBox = new Rectangle(5, 10, 20, 30); 
Edible e = null; 


Which of the following assignment statements are legal? 
a. e = sub; 
sub = e; 
sub = (Sandwich) e; 


(Sandwich) cerealBox; 


WN 

= 
on 
Il 


cerealBox; 
e = (Edible) cerealBox; 


e = (Rectangle) cerealBox; 


rom mo aos 
a>) 
II 


e = (Rectangle) null; 


ike ~=Exercise R9.4. How does a cast such as (BankAccount) x differ from a cast of number 
values such as (int) x? 


*k%* Exercise R9.5. The classes Rectangle2D.Double, Ellipse2D.Double, and Line2D.Double 
implement the Shape interface. The Graphics2D class depends on the Shape interface 
but not on the rectangle, ellipse, and line classes. Draw a UML diagram denoting 
these facts. 


** Exercise R9.6. Suppose r contains a reference to a new Rectangle(5, 10, 20, 30). 
Which of the following assignments is legal? (Look inside the API documentation 
to check which interfaces the Rectangle class implements.) 


a. Rectangle a = Pr; 

. Shape b = r; 

String ¢ = fF: 

. ActionListener d = r; 
. Measurable e = r; 


Serializable f =r; 


mmm eaoseg 


. Object g = 1; 


os 
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Exercise R9.7. Classes such as Rectangle2D.Double, Ellipse2D.Double and 
Line2D.Double implement the Shape interface. The Shape interface has a method 


Rectangle getBounds() 
that returns a rectangle completely enclosing the shape. Consider the method call: 


Shape s=.. .3 
Rectangle r = s.getBounds(); 


Explain why this is an example of polymorphism. 


Exercise R9.8. In Java, a method call such as x.f© uses late binding —the exact 
method to be called depends on the type of the object to which x refers. Give two 
kinds of method calls that use early binding in Java. 


Exercise R9.9. Suppose you need to process an array of employees to find the average 
and the highest salaries. Discuss what you need to do to use the implementation of 
the DataSet class in Section 9.1 (which processes Measurable objects). What do you 
need to do to use the second implementation (in Section 9.4)? Which is easier? 


Exercise R9.10. What happens if you add a String object to the implementation of 
the DataSet class in Section 9.12 What happens if you add a String object toa 
DataSet object of the implementation in Section 9.4 that uses a RectangleMeasurer 
class? 


Exercise R9.11. How would you reorganize the DataSetTester3 program if you 
needed to make RectangleMeasurer into a top-level class (that is, not an inner class)? 


Exercise R9.12. What is a callback? Can you think of another use for a callback for 
the DataSet class? (Hint: Exercise P9.8.) 


Exercise R9.13. Consider this top-level and inner class. Which variables can the f 
method access? 


public class T 


{ 
public void m(final int x, int y) 
{ 
ihe. a: 
final int b; 


class C implements I 


{ 
public void fQ 


{ 


} 
} 


Tindal Tt c: 
} 


private int t; 


} 
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Exercise R9.14. What happens when an inner class tries to access a non-final local 
variable? Try it out and explain your findings. 


Exercise R9.15. How would you reorganize the InvestmentViewerl program if you 
needed to make AddInterestListener into a top-level class (that is, not an inner 
class)? 


Exercise R9.16. What is an event object? An event source? An event listener? 


Exercise R9.17. From a programmer’s perspective, what is the most important 
difference between the user interfaces of a console application and a graphical 
application? 


Exercise R9.18. What is the difference between an ActionEvent and a MouseEvent? 


Exercise R9.19. Why does the ActionListener interface have only one method, 
whereas the MouseListener has five methods? 


Exercise R9.20. Can a class be an event source for multiple event types? If so, give an 
example. 


Exercise R9.21. What information does an action event object carry? What additional 
information does a mouse event object carry? 


Exercise R9.22. Why are we using inner classes for event listeners? If Java did not 
have inner classes, could we still implement event listeners? How? 


Exercise R9.23. What is the difference between the paintComponent and repaint 
methods? 


Exercise R9.24. What is the difference between a frame and a panel? 


Additional review exercises are available in WileyPLUS. 


PROGRAMMING EXERCISES 


Exercise P9.1. Have the Die class of Chapter 6 implement the Measurable interface. 
Generate dice, cast them, and add them to the implementation of the DataSet class 
in Section 9.1. Display the average. 


Exercise P9.2. Define a class Quiz that implements the Measurable interface. A quiz 
has a score and a letter grade (such as B+). Use the implementation of the DataSet 
class in Section 9.1 to process a collection of quizzes. Display the average score and 
the quiz with the highest score (both letter grade and score). 


Exercise P9.3. A person has a name and a height in centimeters. Use the implemen- 
tation of the DataSet class in Section 9.4 to process a collection of Person objects. 
Display the average height and the name of the tallest person. 


Exercise P9.4. Modify the implementation of the DataSet class in Section 9.1 (the one 
processing Measurable objects) to also compute the minimum data element. 
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Exercise P9.5. Modify the implementation of the DataSet class in Section 9.4 (the one 
using a Measurer object) to also compute the minimum data element. 


Exercise P9.6. Using a different Measurer object, process a set of Rectangle objects to 
find the rectangle with the largest perimeter. 


Exercise P9.7. Enhance the DataSet class so that it can either be used with a Measurer 
object or for processing Measurable objects. Hint: Supply a default constructor that 
implements a Measurer that processes Measurable objects. 


Exercise P9.8. Define an interface Filter as follows: 


public interface Filter 


{ 


} 


Modity the implementation of the DataSet class in Section 9.4 to use both a Measurer 
and a Filter object. Only objects that the filter accepts should be processed. Dem- 
onstrate your modification by having a data set process a collection of bank 
accounts, filtering out all accounts with balances less than $1,000. 


boolean accept(Object x); 


Exercise P9.9. Look up the definition of the standard Comparab]e interface in the API 
documentation. Modify the DataSet class of Section 9.1 to accept Comparable 
objects. With this interface, it is no longer meaningful to compute the average. The 
DataSet class should record the minimum and maximum data values. Test your 
modified DataSet class by adding a number of String objects. (The String class 
implements the Comparab1e interface.) 


Exercise P9.10. Modify the Coin class to have it implement the Comparable interface. 


Exercise P9.11. The System.out.printf method has predefined formats for printing 
integers, floating-point numbers, and other data types. But it is also extensible. If 
you use the S format, you can print any class that implements the Formattable 
interface. That interface has a single method: 


void formatTo(Formatter formatter, int flags, int width, int precision) 


In this exercise, you should make the BankAccount class implement the Formattable 
interface. Ignore the flags and precision and simply format the bank balance, using 
the given width. In order to achieve this task, you need to get an Appendab1e refer- 
ence like this: 


Appendable a = formatter.outQ(); 
Appendab1e is another interface with a method 
void append(CharSequence sequence) 


CharSequence is yet another interface that is implemented by (among others) the 
String class. Construct a string by first converting the bank balance into a string 
and then padding it with spaces so that it has the desired width. Pass that string to 
the append method. 
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Exercise P9.12. Enhance the formatTo method of Exercise P9.11 by taking into 
account the precision. 


Exercise P9.13. Write a method randomShape that randomly generates objects imple- 
menting the Shape interface: some mixture of rectangles, ellipses, and lines, with 
random positions. Call it 10 times and draw all of them. 


Exercise P9.14. Enhance the ButtonViewer program so that it prints a message 
“T was clicked n times!” whenever the button is clicked. The value x should be 
incremented with each click. 


Exercise P9.15. Enhance the ButtonViewer program so that it has two buttons, each of 
which prints a message “I was clicked 7 times!” whenever the button is clicked. 
Each button should have a separate click count. 


Exercise P9.16. Enhance the ButtonViewer program so that it has two buttons labeled 
A and B, each of which prints a message “Button x was clicked!”, where x is A or B. 


Exercise P9.17. Implement a ButtonViewer program as in Exercise P9.16, using only a 
single listener class. 


Exercise P9.18. Enhance the ButtonViewer program so that it prints the time at which 
the button was clicked. 


Exercise P9.19. Implement the AddInterestListener in the InvestmentViewerl pro- 
gram as a regular class (that is, not an inner class). Hint: Store a reference to the 
bank account. Add a constructor to the listener class that sets the reference. 


Exercise P9.20. Implement the AddInterestListener in the InvestmentViewer2 pro- 
gram as a regular class (that is, not an inner class). Hint: Store references to the bank 
account and the label in the listener. Add a constructor to the listener class that sets 
the references. 


Exercise P9.21. Write a program that uses a timer to print the current time once a 
second. Hint: The following code prints the current time: 

Date now = new Date(); 

System.out.printIn(Cnow) ; 


The Date class is in the java.util package. 


Exercise P9.22. Change the RectangleComponent for the animation program 1n Section 
9.9 so that the rectangle bounces off the edges of the component rather than simply 
moving outside. 


Exercise P9.23. Write a program that animates a car so that it moves across a frame. 


Exercise P9.24. Write a program that animates two cars moving across a frame in 
opposite directions (but at different heights so that they don’t collide.) 


Exercise P9.25. Change the RectangleComponent for the mouse listener program in 
Section 9.10 so that a new rectangle is added to the component whenever the mouse 
is clicked. Hint: Keep an ArrayList<Rectangle> and draw all rectangles in the paint- 
Component method. 
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Exercise P9.26. Write a program that demonstrates the growth of a roach population. 
Start with two roaches and double the number of roaches with each button click. 


Additional programming exercises are available in WileyPLUS. 


PROGRAMMING PROJECTS | 


Project 9.1. Design an interface MoveableShape that can be used as a generic mecha- 
nism for animating a shape. A moveable shape must have two methods: move and 
draw. Write a generic AnimationPanel that paints and moves any MoveableShape (or 
array list of MoveableShape objects if you covered Chapter 7). Supply moveable rect- 
angle and car shapes. 


Project 9.2. Your task is to design a general program for managing board games with 
two players. Your program should be flexible enough to handle games such as tic- 
tac-toe, chess, or the Game of Nim of Project 6.2. 


Design an interface Game that describes a board game. Think about what your pro- 
gram needs to do. It asks the first player to input a move—a string in a 
game-specific format, such as Be3 in chess. Your program knows nothing about spe- 
cific games, so the Game interface must have a method such as 


boolean isValidMove(String move) 


Once the move is found to be valid, it needs to be executed —the interface needs 
another method executeMove. Next, your program needs to check whether the game 
is over. If not, the other player’s move is processed. You should also provide some 
mechanism for displaying the current state of the board. 


Design the Game interface and provide two implementations of your choice—such as 
Nim and Chess (or TicTacToe if you are less ambitious). Your GameP layer class should 
manage a Game reference without knowing which game is played, and process the 
moves from both players. Supply two programs that differ only in the initialization 
of the Game reference. 
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ANSWERS TO SELF-CHECK QUESTIONS 


1. 


11. 


12. 


13. 
14. 
15. 


16. 
17. 
18. 
Ibe 


20. 


21. 


ye 


It must implement the Measurable interface, and its getMeasure method must 
return the population. 


The Object class doesn’t have a getMeasure method, and the add method invokes 
the getMeasure method. 


Only if x actually refers to a BankAccount object. 


No—a Coin reference can be converted to a Measurable reference, but if you 
attempt to cast that reference to a BankAccount, an exception occurs. 


_ Measurable is an interface. Interfaces have no fields and no method 


implementations. 


That variable never refers to a Measurable object. It refers to an object of some 
class—a class that implements the Measurable interface. 


Both describe a situation where one method name can denote multiple meth- 
ods. However, overloading is resolved early by the compiler, by looking at the 
types of the parameter variables. Polymorphism is resolved late, by looking at 
the type of the implicit parameter object just before making the call. 


The String class doesn’t implement the Measurable interface. 


. Implement a class StringMeasurer that implements the Measurer interface. 


. A measurer measures an object, whereas getMeasure measures “itself”, that is, 


the implicit parameter. 


Inner classes are convenient for insignificant classes. Also, their methods can 
access variables and fields from the surrounding scope. 


Four: one for the outer class, one for the inner class, and two for the DataSet 
and Measurer classes. 


The button object is the event source. The listener object is the event listener. 
The ClickListener class implements the ActionListener interface. 


Direct access is simpler than the alternative— passing the variable as a parameter 
to a constructor or method. 


The local variable must be declared as final. 
First add label to the panel, then add button. 
The actionPerformed method does not access that variable. 


The timer needs to call some method whenever the time interval expires. It calls 
the actionPerformed method of the listener object. 


The moved rectangles won’t be painted, and the rectangle will appear to be 
stationary until the frame is repainted for an external reason. 


Because you know the current mouse position, not the amount by which the 
mouse has moved. 


It implements the MouseListener interface, which has five methods. 
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To use inheritance for customizing user interfaces 


Chapter 


Inheritance 


To learn about inheritance 
To understand how to inherit and override superclass methods 


To be able to invoke superclass constructors 


To learn about protected and package access control 


To understand the common superclass Object and how to 
override its toString and equals methods 


In this chapter, we discuss the important concept of inheritance. Specialized classes 
can be created that inherit behavior from more general classes. You will learn how 
to implement inheritance in Java, and how to make use of the Object class—the 


most general class in the inheritance hierarchy. 
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Inheritance is a mechanism for enhancing existing classes. I you 
need to implement a new class and a class representing a more gen- 
eral concept is already available, then the new class can inherit from 
the existing class. For example, suppose you need to define a class 
SavingsAccount to model an account that pays a fixed interest rate on 
deposits. You already have a class BankAccount, and a savings account 
is a special case of a bank account. In this case, it makes sense to use the language 
construct of inheritance. Here is the syntax for the class definition: 


Inheritance isa : 

mechanism for extending 

existing classes by adding 
methods and fields. 


The more general class is 


Every class extends the 


: more specialize - 
that. inherits from the 
_ superclass is. called is” 

a as a a = 
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class SavingsAccount extends BankAccount 


new methods 
new instance fields 


In the SavingsAccount class definition you specify only new methods and instance 
fields. The SavingsAccount class automatically inherits all methods and instance fields 
of the BankAccount class. For example, the deposit method automatically applies to 
savings accounts: 


SavingsAccount collegeFund = new SavingsAccount (10); 
// Savings account with 10% interest 
col legeFund.deposit(500) ; 
// OK to use BankAccount method with SavingsAccount object 


We must introduce some more terminology here. The more general 
class that forms the basis for inheritance is called the superclass. The 
more specialized class that inherits from the superclass is called the 
subclass. In our example, BankAccount is the superclass and Savings- 
Account is the subclass. 

In Java, every class that does not specifically extend another class 
is a subclass of the class Object. For example, the BankAccount class 
extends the class Object. The Object class has a small number of methods 
that make sense for all objects, such as the toString method, which 


Object class either you can use to obtain a string that describes the state of an object. 
directly. or indirectly. ae Figure 1 is a class diagram showing the relationship between the 


three classes Object, BankAccount, and Savi ngsAccount. In a class dia- 
gram, you denote inheritance by a solid arrow with a “hollow triangle” 
tip that points to the superclass. 


Object 


~ BankAccount _ 


SavingsAccount 
Figure 1  - 
An Inheritance Diagram 
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You may wonder at this point in what way inheritance differs 
from implementing an interface. An interface is not a class. It has o 
state and no behavior. It merely tells you which methods you should 
implement. A superclass has state and behavior, and the subclasses 
inherit them. 

One important reason for inheritance is code reuse. By inheriting 
an existing class, you do not have to replicate the effort that went 
into designing and perfecting that class. For example, when imple- 
menting the SavingsAccount class, you can rely on the withdraw, 
deposit, and getBalance methods of the BankAccount class without 
touching them. 

Let’s see how savings account objects are different from Bank- 
Account objects. We will set an interest rate in the constructor, and we 
need a method to apply that interest periodically. That is, in addition 
to the three methods that can be applied to every account, there is an 
additional method addInterest. The new method and instance field 
must be defined in the subclass. 


public class SavingsAccount extends BankAccount 


: 


public SavingsAccount(double rate) 


A 
} 


Constructor implementation 


public void addInterest() 


Method implementation 
} 


private double interestRate; 


} 


Figure 2 shows the layout of a SavingsAccount object. It inherits the balance 
instance field from the BankAccount superclass, and it gains one additional instance 
field: interestRate. 

Next, you need to implement the new addInterest method. The method com- 
putes the interest due on the current balance and deposits that interest to the 
account. 


BankAccount portion 


Figure 2 Layout of a Subclass Object 
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SYNTAX 10.1 Inheritance 


class SubclassName extends SuperclassName 


{ 
methods 
instance fields 
} 
Example: 
public class SavingsAccount extends BankAccount 
| 
public SavingsAccount(double rate) 
{ 
interestRate = rate; 
} 
public void addInterest() 
{ 
double interest = getBalance() * interestRate / 100; 
deposit(interest) ; 
} 
private double interestRate; 
} 
Purpose: 


To define a new class that inherits from an existing class, and define the methods and 
instance fields that are added in the new class 


public class SavingsAccount extends BankAccount 


{ 
public SavingsAccount(double rate) 
{ 
interestRate = rate; 
} 
public void addInterest() 
{ 
double interest = getBalance() * interestRate / 100; 
deposit(interest); 
} 
private double interestRate; 
; 


You may wonder why the addInterest method calls the getBalance and deposit 
methods rather than directly updating the balance field of the superclass. This is a 
consequence of encapsulation. The balance field was defined as private in the 
BankAccount class. The addInterest method is defined in the SavingsAccount class. It 
does not have the right to access a private field of another class. 
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Note how the addInterest method calls the getBalance and deposit methods of 
the superclass without specifying an implicit parameter. This means that the calls 
apply to the same object, that is, the implicit parameter of the addInterest method. 
For example, if you call 


collegeFund.addInterestQ() ; 
then the following instructions are executed: 


double interest = collegeFund.getBalance() 
* collegeFund.interestRate / 100; 
collegeFund.deposit(Cinterest) ; 


In other words, the statements in the addInterest method are a shorthand for the 
following statements: 


double interest = this.getBalance() 
* this.interestRate / 100; 
this.deposit(Cinterest) ; 


(Recall that the this variable holds a reference to the implicit parameter.) 


SELF CHECK 


1. Which instance fields does an object of class SavingsAccount have? 
2. Name four methods that you can apply to SavingsAccount objects. 


3. If the class Manager extends the class Employee, which class is the superclass and 
which 1s the subclass? 
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Confusing Super- and Subclasses 


If you compare an object of type SavingsAccount with an object of type BankAccount, then 
you find that 


© The keyword extends suggests that the SavingsAccount object is an extended version of a 
BankAccount. 


e The SavingsAccount object is larger; it has an added instance field interestRate. 
e The SavingsAccount object is more capable; it has an addInterest method. 


It seems a superior object in every way. So why is SavingsAccount called the szbclass and 
BankAccount the superclass? 

The super/sub terminology comes from set theory. Look at the set of all bank accounts. 
Not all of them are SavingsAccount objects; some of them are other kinds of bank accounts. 
Therefore, the set of SavingsAccount objects is a subset of the set of all BankAccount objects, 
and the set of BankAccount objects is a superset of the set of SavingsAccount objects. The 
more specialized objects in the subset have a richer state and more capabilities. 
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- Sets of classes c 


“complex i 


In the real world, you often categorize concepts into hierarchies. Hierarchies are 
frequently represented as trees, with the most general concepts at the root of the 
hierarchy and more specialized ones towards the branches. Figure 3 shows a typical 
example. 


In Java it is equally common to group classes in complex imherit- 
ance hierarchies. The classes representing the most general concepts 
are near the root, more specialized classes towards the branches. For 
example, Figure 4 shows part of the hierarchy of Swing user interface 
components 1n Java. 

When designing a hierarchy of classes, you ask yourself which features and 
behaviors are common to all the classes that you are designing. Those common 
properties are collected in a superclass. For example, all user interface components 
have a width and height, and the getWidth and getHeight methods of the JComponent 
class return the component’s dimensions. More specialized properties can be found 
in subclasses. For example, buttons can have text and icon labels. The class 
AbstractButton, but not the superclass JComponent, has methods to set and get the 
button text and icon, and instance fields to store them. The individual button classes 
(such as JButton, JRadioButton, and JCheckBox) inherit these properties. In fact, the 
AbstractButton class was created to express the commonality among these buttons. 


Archosaurs ~ 
- Thecodonts Pterosaurs Dinosaurs Crocodilians 
Saurischians Ornithischians 


Figure 3 A Part of the Hierarchy of Ancient Reptiles 


444 


CHAPTER 10 «# Inheritance 


~ JComponent 


a JPanel _ a xttComponent JLabel | _ Abst 


JTextField =-——“SJTextArea JToggleButton 


—JCheckBox = J Ra 


Figure 4 A Part of the Hierarchy of Swing User Interface Components 


We will use a simpler example of a hierarchy in our study of inheritance con- 
cepts. Consider a bank that offers its customers the following account types: 


1. The checking account has no interest, gives you a small number of free 
transactions per month, and charges a transaction fee for each additional 
transaction. 


2. The savings account earns interest that compounds monthly. (In our imple- 
mentation, the interest is compounded using the balance of the last day of the 
month, which is somewhat unrealistic. Typically, banks use either the average 
or the minimum daily balance. Exercise P10.1 asks you to implement this 
enhancement.) 


Figure 5 shows the inheritance hierarchy. Exercise P10.2 asks you to add another 
class to this hierarchy. 

Next, let us determine the behavior of these classes. All bank accounts support 
the getBalance method, which simply reports the current balance. They also sup- 
port the deposit and withdraw methods, although the details of the implementation 
differ. For example, a checking account must keep track of the number of transac- 
tions to account for the transaction fees. 


10.3 


Inheriting Instance. 
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BankAccount 


SavingsAccount CheckingAccount 


Figure 5 Inheritance Hierarchy for Bank Account Classes 


The checking account needs a method deductFees to deduct the monthly fees and 
to reset the transaction counter. The deposit and withdraw methods must be rede- 
fined to count the transactions. 

The savings account needs a method addInterest to add interest. 

To summarize: The subclasses support all methods from the superclass, but their 
implementations may be modified to match the specialized purposes of the sub- 
classes. In addition, subclasses are free to introduce additional methods. 


SELF CHECK 


4. What is the purpose of the JTextComponent class in Figure 4? 
5. Which instance field will we need to add to the CheckingAccount class? 


-ields and Methods 


When you form a subclass of a given class, you can specify additional instance fields 
and methods. In this section we will discuss this process in detail. 
When defining the methods for a subclass, there are three possibilities. 


1. You can override methods from the superclass. If you specify a method 
with the same signature (that is, the same name and the same parameter types), 
it overrides the method of the same name in the superclass. Whenever 
the method is applied to an object of the subclass type, the overriding 
method, and not the original method, is executed. For example, Checking- 
Account.deposit overrides BankAccount.deposit. 


2. You can inherit methods from the superclass. If you do not explicitly override 
a superclass method, you automatically inherit it. The superclass method can 
be applied to the subclass objects. For example, the SavingsAccount class 
inherits the BankAccount.getBalance method. 
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3. You can define new methods. If you define a method that did not exist in the 
superclass, then the new method can be applied only to subclass objects. For 
example, SavingsAccount.addInterest is anew method that does not exist in 
the superclass BankAccount. 


The situation for instance fields is quite different. You can never override instance 
fields. For fields in a subclass, there are only two cases: 


1. The subclass inherits all fields from the superclass. All instance fields from the 
superclass are automatically inherited. For example, all subclasses of the 
BankAccount class inherit the instance field balance. 


2. Any new instance fields that you define in the subclass are present only in 
subclass objects. For example, the subclass SavingsAccount defines a new 
instance field interestRate. 


What happens if you define a new field with the same name as a superclass field? 
For example, can you define another field named balance in the SavingsAccount 
class? This is legal but extremely undesirable. Each SavingsAccount object would 
have two instance fields of the same name. The two fields can hold different values 
which is likely to lead to confusion—see Common Error 10.2. 

We already implemented the BankAccount and SavingsAccount classes. Now we 
will implement the subclass CheckingAccount so that you can see in detail how meth- 
ods and instance fields are inherited. Recall that the BankAccount class has three 
methods and one instance field: 


>) 


public class BankAccount 


{ 
public double getBalance() { . . . } 
public void deposit(double amount) { .. . } 
public void withdraw(double amount) { . . . } 
private double balance; 

j 


The CheckingAccount class has an added method deductFees and an added instance 
field transactionCount, and it overrides the deposit and withdraw methods to incre- 
ment the transaction count: 


public class CheckingAccount extends BankAccount 


{ 
public void deposit(double amount) { .. . } 
public void withdraw(double amount) { .. . } 
public void deductFees() { ... } 
private int transactionCount; 

} 


Each object of class CheckingAccount has two instance fields: 


® balance (inherited from BankAccount) 


® transactionCount (new to CheckingAccount) 


10.3 = Inheriting Instance Fields and Methods 447 


You can apply four methods to CheckingAccount objects: 


© getBalance() (inherited from BankAccount) 

© deposit(double amount) (overrides BankAccount method) 

© withdraw(double amount) (overrides BankAccount method) 

® deductFees() (new to CheckingAccount) 

Next, let us implement these methods. The deposit method increments the transac- 
tion count and deposits the money: 


public class CheckingAccount extends BankAccount 


public void deposit(double amount) 
transactionCount++; 
// Now add amount to balance 
} 
} 


Now we have a problem. We can’t simply add amount to balance: 


public class CheckingAccount extends BankAccount 


1 
public void deposit(double amount) 
{ 
transactionCount++; 
// Now add amount to balance 
balance = balance + amount; // Error 
} 
} 


Although every CheckingAccount object has a balance instance field, 
that instance field is private to the superclass BankAccount. Subclass 
methods have no more access rights to the private data of the super- 
class than any other methods. If you want to modify a private 
superclass field, you must use a public method of the superclass. 

How can we add the deposit amount to the balance, using the public interface of 
the BankAccount class? There is a perfectly good method for that purpose—namely, 
the deposit method of the BankAccount class. So we must invoke the deposit method 
on some object. On which object? The checking account into which the money 1s 
deposited —that is, the implicit parameter of the deposit method of the Checking- 
Account class. To invoke another method on the implicit parameter, you don’t 
specify the parameter but simply write the method name, like this: 


public class CheckingAccount extends BankAccount 
{ 
public void deposit(double amount) 
{ 
transacti1onCount++; 
// Now add amount to balance 
deposit(amount); // Not complete 
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} 

But this won’t quite work. The compiler interprets 
deposit(amount) ; 

as 
this.deposit(Camount) ; 


The this parameter is of type CheckingAccount. There is a method called deposit in 
the CheckingAccount class. Therefore, that method will be called—but that is just the 
method we are currently writing! The method will call itself over and over, and the 
program will die in an infinite recursion (discussed in Chapter 13). 

Instead, we must be specific that we want to invoke only the super- 


Use the super keywordto — (J7.% deposit method. There is a special keyword super for this purpose: 


call a method of the 


Superclass. public class CheckingAccount extends BankAccount 
, { 
public void deposit(double amount) 
{ 
transactionCount++; 
// Nowadd amount to balance 
super, depositCamount) ; 


} 
_- 


This version of the deposit method is correct. To deposit money into a checking 
account, update the transaction count and call the deposit method of the superclass. 
The remaining methods are now straightforward. 


public class CheckingAccount extends BankAccount 


{ 
public void withdraw(double amount) 
7 
transactionCount++; 
// Now subtract amount from balance 
super.withdraw(Camount) ; 
} 
public void deductFees() 
if 
1f (transactionCount > FREE_TRANSACTIONS) 
1 
double fees = TRANSACTION FEE 
* (transactionCount - FREE_TRANSACTIONS); 
super.withdraw(fees); 
} 
transactionCount = 0; 
} 


private static final int FREE_TRANSACTIONS = 3; 
private static final double TRANSACTION FEE = 2.0: 
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SYNTAX 10.2 Calling a Superclass Method 


NNO AAI AEE CE LR AL A AEE I RT ST ANALY TS LT TE I NT SE EN 


super.methodName (parameters) ; 


Example: 


public void deposit(double amount) 


{ 
transactionCount++ ; 
super.deposit (amount) ; 
; 
Purpose: 


To call a method of the superclass instead of the method of the current class 


SELF CHECK 


6. Why does the withdraw method of the CheckingAccount class call 
super.withdraw? 


7. Why does the deductFees method set the transaction count to zero? 


COMMON Error 10.2 


Shadowing Instance Fields 


A subclass has no access to the private instance fields of the superclass. For example, the 
methods of the CheckingAccount class cannot access the balance field: 


public class CheckingAccount extends BankAccount 


{ 
public void deposit(double amount) 
{ 
transactionCount++; 
balance = balance + amount; // Error 
} 
} 


It is a common beginner’s error to “solve” this problem by adding another instance field 
with the same name. 


public class CheckingAccount extends BankAccount 


{ 


public void deposit(double amount) 


{ 


450 


CHAPTER 10 «8 Inheritance 


transactionCount++; 
balance = balance + amount; 


} 


private double balance; // Don’t 


} 


Sure, now the deposit method compiles, but it doesn’t update the correct balance! Such a 
CheckingAccount object has two instance fields, both named balance (see Figure 6). The 
getBalance method of the superclass retrieves one of them, and the deposit method of the 
subclass updates the other. 


BankAccount portion 


Figure 6 Shadowing Instance Fields 


COMMON ERROR 10.3 
Failing to Invoke the Superclass Method 


A common error in extending the functionality of a superclass method is to forget the super. 
qualifier. For example, to withdraw money from a checking account, update the transaction 
count and then withdraw the amount: 


public void withdraw(double amount) 


{ 

transactionCount++; 

withdraw(Camount) ; 

// Error—should be super.withdraw(amount) 
} 


Here withdraw(amount) refers to the withdraw method applied to the implicit parameter of the 
method. The implicit parameter is of type CheckingAccount, and the CheckingAccount class 
has a withdraw method, so that method is called. Of course, that calls the current method all 
over again, which will call itself yet again, over and over, until the program runs out of mem- 
ory. Instead, you must precisely identify which withdraw method you want to call. 

Another common error is to forget to call the superclass method altogether. Then the 
functionality of the superclass mysteriously vanishes. 
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In this section, we discuss the implementation of constructors in subclasses. As an 
example, let us define a constructor to set the initial balance of a checking account. 

We want to invoke the BankAccount constructor to set the balance to the initial 
balance. There is a special instruction to call the superclass constructor from a sub- 
class constructor. You use the keyword super, followed by the construction param- 
eters in parentheses: 


public class CheckingAccount extends BankAccount 


{ 
public CheckingAccount(double initialBalance) 
{ 
// Construct superclass 
superCinitialBalance) ; 
// Initialize transaction count 
transactionCount = 0; 
7 
} 


When the keyword super is followed by a parenthesis, it indicates a 
call to the superclass constructor. When used in this way, the con- 
structor call must be the first statement of the subclass constructor. If 
super is followed by a period and a method name, on the other hand, 
it indicates a call to a superclass method, as you saw in the preceding 
section. Such a call can be made anywhere in any subclass method. 


SYNTAX 10.3 Calling a Superclass Constructor 


RRR Ee eR EASA RS SS SE TR SS 


accessSpecifier ClassName(parameterType parameterName,. . .) 
{ 
super (parameters) ; 
} 
Example: 
public CheckingAccount(double initialBalance) 
{ 
superCinitialBalance) ; 
transactionCount = 0; 
} 
Purpose: 


To invoke the constructor of the superclass. Note that this statement must be the first 
statement of the subclass constructor. 
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The dual use of the super keyword is analogous to the dual use of the this keyword 
(see Advanced Topic 3.1). 

If a subclass constructor does not call the superclass constructor, the superclass is 
constructed with its default constructor (that is, the constructor that has no 
parameters). However, if all constructors of the superclass require parameters, then 
the compiler reports an error. 

For example, you can implement the CheckingAccount constructor without call- 
ing the superclass constructor. Then the BankAccount class is constructed with its 
default constructor, which sets the balance to zero. Of course, then the Checki ng- 
Account constructor must explicitly deposit the initial balance. 

Most commonly, however, subclass constructors have some parameters that they 
pass on to the superclass and others that they use to initialize subclass fields. 


SELF CHECK 


8. Why didn’t the SavingsAccount constructor in Section 10.1 call its superclass 
constructor? 


9. When you invoke a superclass method with the super keyword, does the call 
have to be the first statement of the subclass method? 


10.5 Converting Between Subclass and 


It is often necessary to convert a subclass type to a superclass type. Occasionally, 
you need to carry out the conversion in the opposite direction. This section dis- 
cusses the conversion rules. 


The class SavingsAccount extends the class BankAccount. In other 
words, a SavingsAccount object is a special case of a BankAccount 
object. Therefore, a reference to a SavingsAccount object can be con- 
verted to a BankAccount reference. 


converted to sul erclass 
references. | 1 


SavingsAccount collegeFund = new SavingsAccount(10); 
BankAccount anAccount = collegeFund; 


Furthermore, all references can be converted to the type Object. 
Object anObject = collegeFund; 


Now the three object references stored in collegeFund, anAccount, and anObject all 
reter to the same object of type SavingsAccount (see Figure 7). 

However, the object reference anAccount knows less than the full story about the 
object to which it refers. Because anAccount is an object of type BankAccount, you 
can use the deposit and withdraw methods to change the balance of the savings 
account. You cannot use the addInterest method, though—it is not a method of the 
BankAccount superclass: 
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Il 


collegeFund 


anAccount 


ll 


anObject 


Figure 7 Variables of Different Types Refer to the Same Object 


anAccount.deposit(1000); // OK 
anAccount.addInterestQ) ; 
// No—nota method of the class to which anAccount belongs 


And, of course, the variable anObject knows even less. You can’t even apply the 
deposit method to it—deposit is not a method of the Object class. 

Conversion of references is different from a numerical conversion, such as a con- 
version from an integer to a floating-point number. If you convert an integer, say 4, 
into the double value 4.0, then the representation changes: the double value 4.0 uses a 
different sequence of bits than the int value 4. However, when you convert a 
SavingsAccount reference to a BankAccount reference, then the value of the reference 
stays the same—it is the memory location of the object. However, after conversion, 
less information is known about the object. We only know that it is a bank account. 
It might be a plain bank account, a savings account, or another kind of bank account. 

Why would anyone want to know less about an object and store a reference in an 
object field of a superclass? This can happen if you want to reuse code that knows 
about the superclass but not the subclass. Here is a typical example. Consider a 
transfer method that transfers money from one account to another: 


public void transfer(double amount, BankAccount other) 


{ 
withdraw(Camount) ; 
other.depositCamount) ; 


} 
You can use this method to transfer money from one bank account to another: 


BankAccount momsAccount =... . ; 
BankAccount harrysAccount =... 5 
momsAccount.transfer(1000, harrysAccount) ; 


You can also use the method to transfer money into a CheckingAccount: 


CheckingAccount harrysChecking =... .« ; 
momsAccount.transfer(1000, harrysChecking) ; 
// OK to pass a CheckingAccount reference to a method expecting a BankAccount 


The transfer method expects a reference to a BankAccount, and it gets a reference to 
the subclass CheckingAccount. Fortunately, rather than complaining about a type 
mismatch, the compiler simply copies the subclass reference harrysChecking to the 
superclass reference other. The transfer method doesn’t actually know that, in this 
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case, other refers to a CheckingAccount reference. It knows only that other is a 
BankAccount, and it doesn’t need to know anything else. All it cares about is that the 
other object can carry out the deposit method. 

Very occasionally, you need to carry out the opposite conversion, from a super- 
class reference to a subclass reference. For example, you may have a variable of type 
Object, and you know that it actually holds a BankAccount reference. In that case, 
you can use a cast to convert the type: 


BankAccount anAccount = (BankAccount) anObject; 


However, this cast is somewhat dangerous. If you are wrong, and anObject actually 
refers to an object of an unrelated type, then an exception is thrown. 

To protect against bad casts, you can use the instanceof operator. 
It tests whether an object belongs to a particular type. For example, 


anObject instanceof BankAccount 


returns true if the type of anObject is convertible to BankAccount. This 
happens if anObject refers to an actual BankAccount or a subclass such as Savings- 
Account. Using the instanceof operator, a safe cast can be programmed as follows: 


1f CanObject instanceof BankAccount) 


{ 


BankAccount anAccount = (BankAccount) anObject; 


SYNTAX 10.4 The instanceof Operator 
Boks 


object instanceof TypeName 


Example: 
1f CanObject instanceof BankAccount) 
{ 
BankAccount anAccount = (BankAccount) anObject; 
} 
Purpose: 


To return true if the object is an instance of TypeName (or one of its subtypes), and 
false otherwise 


SELF CHECK 


10. Why did the second parameter of the transfer method have to be of type 
BankAccount and not, for example, SavingsAccount? 


11. Why can’t we change the second parameter of the transfer method to the type 
Object? 
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In Java, the type of a variable does not completely determine the type of the object 
to which it refers. For example, a variable of type BankAccount can hold a reference 
to an actual BankAccount object or a subclass object such as SavingsAccount. You 
already encountered this phenomenon in Chapter 9 with variables whose type was 
an interface. A variable whose type is Measurable holds a reference to an object of a 
class that implements the Measurable interface, perhaps a Coin object or an object of 
an entirely different class. 
What happens when you invoke a method? For example, 


BankAccount anAccount = new CheckingAccount() ; 
anAccount.deposit (1000) ; 


Which deposit method is called? The anAccount parameter has type BankAccount, so 
it would appear as if BankAccount.deposit is called. On the other hand, the 
CheckingAccount class provides its own deposit method that updates the transaction 
count. The anAccount field actually refers to an object of the subclass Checking- 
Account, so it would be appropriate if the CheckingAccount.deposit method were 
called instead. 

In Java, method calls are always determined by the type of the actual object, not 
the type of the object reference. That is, if the actual object has the type Checking- 
Account, then the CheckingAccount.deposit method is called. It does not matter that 
the object reference is stored in a field of type BankAccount. As we discussed in 
Chapter 9, the ability to refer to objects of multiple types with varying behavior is 
called polymorphism. 

If polymorphism is so powerful, why not store all account references in vari- 
ables of type Object? This does not work because the compiler needs to check that 
only legal methods are invoked. The Object type does not define a deposit 
method—the BankAccount type (at least) is required to make a call to the deposit 
method. 

Have another look at the transfer method to see polymorphism at work. Here is 
the implementation of the method: 


public void transfer(double amount, BankAccount other) 


{ . 
withdraw(Camount) ; 
other.depositCamount) ; 

} 

Suppose you call 


anAccount.transfer(1000, anotherAccount) ; 
Two method calls are the result: 


anAccount.withdraw(1000) ; 
anotherAccount.deposit (1000) ; 


Depending on the actual types of anAccount and anotherAccount, different versions 
of the withdraw and deposit methods are called. 


456 


CHAPTER 10 « Inheritance 


If you look into the implementation of the transfer method, it may not be 
immediately obvious that the first method call 


withdraw(Camount) ; 
depends on the type of an object. However, that call is a shortcut for 
this.withdraw(amount) ; 


The this parameter holds a reference to the implicit parameter, which can refer to a 
BankAccount or a subclass object. 

The following program calls the polymorphic withdraw and deposit methods. 
You should manually calculate what the program should print for each account bal- 
ance, and confirm that the correct methods have in fact been called. 


ch10/accounts/Accounttester.java 


l /* w 
Z This aa tests the BankAccount class and 
3 its subclasses. 
4 3 
5 ~=public class AccountTester 
6 { 
7 public static void main(String[] args) 
8 ‘ 
9 SavingsAccount momsSavings 
10 = new SavingsAccount().5); 
ll 
12 CheckingAccount harrysChecking 
13 = new CheckingAccount(1{)); 
14 
15 momsSavings.deposit(/0001); 
16 
17 momsSavings.transfer(/000, harrysChecking) ; 
18 harrysChecking.withdraw(!'50); 
19 harrysChecking.withdraw(/\()) ; 
20 
21 momsSavings.transfer(!000, harrysChecking) ; 
22 harrysChecking.withdraw(4‘\)) ; 
23 
24 // Simulate end of month 
25 momsSavings.addInterest(); 
26 harrysChecking.deductFees(); 
27 
28 System.out.printIn("Mom's savings balance: " 
29 + momsSavings.getBalance()); 
30 System.out.printInC"Expected: 7035"); 
31 
32 System.out.printinC"Harry's checking balance: " 
33 + harrysChecking.getBalance()); 
34 System.out.printInC"Expected: 1116"); 
35 , 
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ch10/accounts/BankAccount.java 


1 /** 
2 A bank account has a balance that can be changed by 
3 deposits and withdrawals. 
4 + 
5 public class BankAccount 
6 { 
v4 J% ¥ 
8 Constructs a bank account with a zero balance. 
9 a 
10 public BankAccount() 
11 { 
12 balance = 0; 
13 } 
14 
15 f* co 
16 Constructs a bank account with a given balance. 
17 @param initialBalance the initial balance 
18 * 
19 public BankAccount(double initialBalance) 
20 1 
21 balance = initialBalance; 
22 } 
23 
24 [e* 
25 Deposits money into the bank account. 
26 @param amount the amount to deposit 
27 * / 
28 public void deposit(double amount) 
29 { 
30 balance = balance + amount; 
eal } 
32 
33 wt 
34 Withdraws money from the bank account. 
35 @param amount the amount to withdraw 
36 * 
37 public void withdraw(double amount) 
38 { 
39 balance = balance - amount; 
40 } 
41 
42 [** 
43 Gets the current balance of the bank account. 
44 @return the current balance 
45 a 
46 public double getBalance() 
47 { 
48 return balance; 
49 } 
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62 


63 } 


[xe 
Transfers money from the bank account to another account. 
@param amount the amount to transfer 
@param other the other account 

a 

public void transfer(double amount, BankAccount other) 

{ 
withdraw(Camount) ; 
other.deposit(amount) ; 


j 


private double balance; 


ch10/accounts/CheckingAccount.java 


A checking account that charges transaction fees. 


public class CheckingAccount extends BankAccount 


/* * 
Constructs a checking account with a given balance. 
@param initialBalance the initial balance 
ad 
public CheckingAccount(double initialBalance) 
{ 
// Construct superclass 
Super(initialBalance) ; 


// Initialize transaction count 
transactionCount = 0; 


} 
public void deposit(double amount) 
1 

transactionCount++; 


// Now add amount to balance 
super.deposit(amount) ; 


} 


public void withdraw(double amount) 
{ 
transactionCount++; 
// Now subtract amount from balance 
super.withdraw(amount) ; 


Deducts the accumulated fees and resets the 
transaction count. 
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37 public void deductFees() 

38 A 

39 if (transactionCount > FREE_TRANSACTIONS) 

40 { 

41 double fees = TRANSACTION FEE * 

42 (transactionCount - FREE_TRANSACTIONS) ; 
43 super.withdraw(fees) ; 

44 } 

45 transactionCount = 0; 

46 } 

47 

48 private int transactionCount; 

49 

50 private static final int FREE_TRANSACTIONS = 3; 
51 private static final double TRANSACTION_FEE = 2.0; 
52 } 


ch10/accounts/SavingsAccount.java 


l | * 
Z An account that earns interest at a fixed rate. 
3 * / 
4 public class SavingsAccount extends BankAccount 
> 4 
6 f* * 
7 Constructs a bank account with a given interest rate. 
8 @param rate the interest rate 
Q * / 
10 public SavingsAccount(double rate) 
11 if 
12 interestRate = rate; 
13 } 
14 
15 “ 
16 Adds the earned interest to the account balance. 
17 * / 
18 public void addInterest() 
19 { 
20 double interest = getBalance() * interestRate / 100; 
ae deposit(interest); 
22 } 
23 
24 private double interestRate; 
25 } 
Output 


Mom's savings balance: 7035.0 
Expected: 7035 

Harry's checking balance: 1116.0 
Expected: 1116 
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SELF CHECK 


12. If a isa variable of type BankAccount that holds a non-nu11 reference, what do 
you know about the object to which a refers? 


13. If a refers to a checking account, what is the effect of calling 
a.transfer(1000, a)? 


ADVANCED Topic 10.1 


Abstract Classes 


When you extend an existing class, you have the choice whether or not to redefine the meth- 
ods of the superclass. Sometimes, it is desirable to force programmers to redefine a method. 
That happens when there is no good default for the superclass, and only the subclass pro- 
grammer can know how to implement the method properly. 

Here is an example. Suppose the First National Bank of Java decides that every account 
type must have some monthly fees. Therefore, a deductFees method should be added to the 
BankAccount class: 


public class BankAccount 


{ 
public void deductFees() { .. . } 


} 


But what should this method do? Of course, we could have the method do nothing. But then 
a programmer implementing a new subclass might simply forget to implement the deduct- 
Fees method, and the new account would inherit the do-nothing method of the superclass. 
There is a better way — declare the deductFees method as an abstract method: 


public abstract void deductFees(); 


An abstract method has no implementation. This forces the 
implementors of subclasses to specify concrete implementa- 
tions of this method. (Of course, some subclasses might 
decide to implement a do-nothing method, but then that is 
their choice—not a silently inherited default.) 

You cannot construct objects of classes with abstract methods. For example, once the 
BankAccount class has an abstract method, the compiler will flag an attempt to create a new 
BankAccount() as an error. Of course, if the CheckingAccount subclass overrides the deduct- 
Fees method and sep an aisle meatar on. then you can create CheckingAccount objects. 

, , A class for which you cannot create objects is called an 
abstract class. A class for which you can create objects is 
sometimes called a concrete class. In Java, you must declare all 
abstract classes with the keyword abstract: 


“An abstract method i is a : ae 


tation is not specined. , 


public abstract class BankAccount 


{ 
public abstract void deductFeesQ() ; 
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A class that defines an abstract method, or that inherits an abstract method without overrid- 
ing it, must be declared as abstract. You can also declare classes with no abstract methods as 
abstract. Doing so prevents programmers from creating instances of that class but allows 
them to create their own subclasses. 

Note that you cannot construct an object of an abstract class, but you can still have an 
object reference whose type is an abstract class. Of course, the actual object to which it refers 
must be an instance of a concrete subclass: 


BankAccount anAccount; // OK 

anAccount = new BankAccount(); // Error—BankAccount is abstract 
anAccount = new SavingsAccount(); // OK 

anAccount = null; // OK 


The reason for using abstract classes is to force programmers to create subclasses. By speci- 
fying certain methods as abstract, you avoid the trouble of coming up with useless default 
methods that others might inherit by accident. 

Abstract classes differ from interfaces in an important way —they can have instance fields, 
and they can have concrete methods and constructors. 


ADVANCED Topic 10.2 
Final Methods and Classes 


In Advanced Topic 10.1 you saw how you can force other programmers to create subclasses 
of abstract classes and override abstract methods. Occasionally, you may want to do the 
opposite and prevent other programmers from creating subclasses or from overriding certain 
methods. In these situations, you use the final keyword. For example, the String class in 
the standard Java library has been declared as 


public final class String {.. . } 


That means that nobody can extend the String class. 

The String class is meant to be immutable—string objects can’t be modified by any of 
their methods. Since the Java language does not enforce this, the class designers did. Nobody 
can create subclasses of String; therefore, you know that all String references can be copied 
without the risk of mutation. 

You can also declare individual methods as final: 


public class SecureAccount extends BankAccount 


{ 
public final boolean checkPassword(String password) 
{ 
} 

} 


This way, nobody can override the checkPassword method with another method that simply 
returns true. 
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Java has four levels of controlling access to fields, methods, and classes: 


® public access 
® private access 
® protected access (see Advanced Topic 10.3) 


e package access (the default, when no access modifier is given) 


You have already used the private and public modifiers extensively. Private features 
can be accessed only by the methods of their own class. Public features can be 
accessed by methods of all classes. We will discuss protected access in Advanced 
Topic 10.3—we will not need it in this book. 

If you do not supply an access control modifier, then the default is 
package access. That is, all methods of classes in the same package can 
access the feature. For example, if a class is declared as public, then 
all other classes in all packages can use it. But if a class is declared 
without an access modifier, then only the other classes in the same 
package can use it. Package access is a good default for classes, but it 
is extremely unfortunate for fields. Instance and static fields of 
classes should always be private. There are a few exceptions: 


e Public constants (public static final fields) are useful and safe. 


e Some objects, such as System. out, need to be accessible to all programs and there- 


fore should be public. 


¢ Very occasionally, several classes in a package must collaborate very closely. In 
that case, it may make sense to give some fields package access. But inner classes 
are usually a better solution— you have seen examples in Chapter 9. 


It is acommon error to forget the keyword private, thereby opening up a potential 
security hole. For example, at the time of this writing, the Window class in the 
java.awt package contained the following declaration: 


public class Window extends Container 


{ 


String warningString; 


i 


The programmer was careless and didn’t make the field private. There actually was 
no good reason to grant package access to the warningString field—no other class 
accesses it. It is a security risk. Packages are not closed entities—any programmer 
can make a new class, add it to the java. awt package, and gain access to the warning- 
String fields of all window objects! (Actually, this possibility bothered the Java 
implementors so much that recent versions of the virtual machine refuse to load 
unknown classes whose package name starts with “java.”. Your own packages, 
however, do not enjoy this protection.) 
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Package access for fields is rarely useful, and most fields are given package access 
by accident because the programmer simply forgot the private keyword. 

Methods should generally be public or private. We recommend avoiding the use 
of package-visible methods. 

Classes and interfaces can have public or package access. Classes that are gener- 
ally useful should have public access. Classes that are used for implementation rea- 
sons should have package access. You can hide them even better by turning them 
into inner classes; you saw examples of inner classes in Chapter 9. There are a few 
examples of public inner classes, such as the E11ipse2D.Doub1e class that you saw in 
Chapter 2 (Section 2.13). However, in general, inner classes should not be public. 


SELF CHECK 


14, What is acommon reason for defining package-visible instance fields? 


15. If aclass with a public constructor has package access, who can construct 
objects of it? 


COMMON ERROR 10.4 
Accidental Package Access 


It is very easy to forget the private modifier for instance fields. 


public class BankAccount 


double balance; // Package access really intended? 


} 


Most likely, this was just an oversight. The programmer probably never intended to grant 
access to this field to other classes in the same package. The compiler won’t complain, of 
course. Much later, some other programmer may take advantage of the access privilege, 
either out of convenience or out of evil intent. This is a serious problem, and you must get 
into the habit of scanning your field declarations for missing private modifiers. 


COMMON ERROR 10.5 


Making Inherited Methods Less Accessible 


If a superclass declares a method to be publicly accessible, you cannot override it to be more 
private. For example, 


public class BankAccount 


{ 
public void withdraw(double amount) { .. . } 
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} 

public class CheckingAccount extends BankAccount 

private void withdraw(double amount) { .. . } 
// Error—subclass method cannot be more private 

} 


The compiler does not allow this, because the increased privacy would be an illusion. Any- 
one can still call the method through a superclass reference: 


BankAccount account = new CheckingAccount() ; 
account.withdraw(100000); // Calls CheckingAccount.withdraw 


Because of polymorphism, the subclass method is called. 

These errors are usually an oversight. If you forget the public modifier, your subclass 
method has package access, which is more restrictive. Simply restore the public modifier, 
and the error will go away. 


ADVANCED Topic 10.3 


Protected Access 


We ran into a hurdle when trying to implement the deposit method of the CheckingAccount 
class. That method needed access to the balance instance field of the superclass. Our remedy 
was to use the appropriate method of the superclass to set the balance. 

Java offers another solution to this problem. The superclass can declare an instance field 
as protected: 


public class BankAccount 


{ 


protected double balance; 


Protected data in an object can be accessed by the methods of 
Protected features can be the object’s class and all its subclasses. For example, 
accessed by all subclasses = Check ingAccount inherits from BankAccount, so its methods 
and allclassesinthe same — can access the protected instance fields of the BankAccount 
package. class. Furthermore, protected data can be accessed by all 
methods of classes in the same package. 

Some programmers like the protected access feature because it seems to strike a balance 
between absolute protection (making all fields private) and no protection at all (making all 
fields public). However, experience has shown that protected fields are subject to the same 
kinds of problems as public fields. The designer of the superclass has no control over the 
authors of subclasses. Any of the subclass methods can corrupt the superclass data. Further- 
more, classes with protected fields are hard to modify. Even if the author of the superclass 
would like to change the data implementation, the protected fields cannot be changed, 
because someone somewhere out there might have written a subclass whose code depends 
on them. 
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In Java, protected fields have another drawback—they are accessible not just by sub- 
classes, but also by other classes in the same package. 

It is best to leave all data private. If you want to grant access to the data to subclass meth- 
ods only, consider making the accessor method protected. 


In Java, every class that is defined without an explicit extends clause automatically 
extends the class Object. That is, the class Object is the direct or indirect superclass 
of every class in Java (see Figure 8). 

Of course, the methods of the Object class are very general. Here are the most 


useful ones: 


_ Method a Purpose 
String toString Returns a string representation of the obje to 


boolean equals(Object otherObject) Tests whether the object equals another object 


It is a good idea for you to override these methods in your classes. 


Figure 8 The Object Class Is the Superclass of Every Java Class 
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The toString method returns a string representation for each object. 
It is used for debugging. For example, 


Rectangle box = new Rectangle(5, 10, 20, 30); 
String s = box.toString(; 
// Sets sto "java.awt.Rectangle[x=5, y=10,width=20,height=30]" 


In fact, this toString method is called whenever you concatenate a string with an 
object. Consider the concatenation 


"box=" + box; 


On one side of the + concatenation operator is a string, but on the other side is an 
object reference. The Java compiler automatically invokes the toString method to 
turn the object into a string. Then both strings are concatenated. In this case, the 
result is the string 


"box=java.awt.Rectangle[x=5, y=10,width=20,height=30]" 


The compiler can invoke the toString method, because it knows that every object 
has a toString method: Every class extends the Object class, and that class defines 
toString. 

As you know, numbers are also converted to strings when they are concatenated 
with other strings. For example, 


int age = 18; 
String s = "Harry's age 1S " + age; 
// Sets sto "Harry's age is 18" 


In this case, the toString method is not involved. Numbers are not objects, and 
there is no toString method for them. There is only a small set of primitive types, 
however, and the compiler knows how to convert them to strings. 

Let’s try the toString method for the BankAccount class: 


BankAccount momsSavings = new BankAccount (5000) ; 
String s = momsSavings.toString(); 
// Sets s to something like "BankAccount@d24606bf" 


That’s disappointing—all that’s printed is the name of the class, followed by the 
hash code, a seemingly random code. The hash code can be used to tell objects 
apart—different objects are likely to have different hash codes. (See Chapter 16 for 
the details.) 

We don’t care about the hash code. We want to know what is inside the object. 
But, of course, the toString method of the Object class does not know what is 
inside the BankAccount class. Therefore, we have to override the method and supply 
our own version in the BankAccount class. We'll follow the same format that the 
toString method of the Rectangle class uses: first print the name of the class, and 
then the values of the instance fields inside brackets. 


public class BankAccount 


{ 


10.8 = Object: The Cosmic Superclass 467 


public String toStringQ 
{ 


} 


return "“BankAccount[balance="" + balance + "]"; 


} 
This works better: 


BankAccount momsSavings = new BankAccount(5000) ; 
String s = momsSavings.toString(); 
// Sets s to "BankAccount[balance=5000]" 


PRODUCTIVITY HINT 10.1 
Supply toString in All Classes 


If you have a class whose toStringQ method returns a string that describes the object state, 
then you can simply call System.out.printIn(x) whenever you need to inspect the current 
state of an object x. This works because the print1n method of the PrintStream class invokes 
x.toString() when it needs to print an object, which is extremely helpful if there is an error 
in your program and the objects don’t behave the way you think they should. You can sim- 
ply insert a few print statements and peek inside the object state during the program run. 
Some debuggers can even invoke the toString method on objects that you inspect. 

Sure, it is a bit more trouble to write a toString method when you aren’t sure your pro- 
gram ever needs one—after all, it might work correctly on the first try. Then again, many 
programs don’t work on the first try. As soon as you find out that yours doesn’t, consider 
adding those toString methods to help you debug the program. 


ADVANCED Topic 10.4 


Inheritance and the toString Method 


You just saw how to write a toString method: Form a string consisting of the class name and 
the names and values of the instance fields. However, if you want your toString method to 
be usable by subclasses of your class, you need to work a bit harder. Instead of hardcoding 
the class name, you should call the getClass method to obtain a class object, an object of the 
Class class that describes classes and their properties. Then invoke the getName method to get 
the name of the class: 


public String toString() 


{ 
return getClass().getName() + "[balance=" 
+ balance + "]"; 


} 


Then the toString method prints the correct class name when you apply it to a subclass, say 
a SavingsAccount. 
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SavingsAccount momsSavings =... . ; 
System.out.printIn(momsSavings) ; 
// Prints "SavingsAccount [balance=10000]" 


Of course, in the subclass, you should override toString and add the values of the subclass 
instance fields. Note that you must call super.toString to get the superclass field values— 
the subclass can’t access them directly. 


public class SavingsAccount extends BankAccount 


{ 
public String toString() 
{ 
return super.toString() + 
"CinterestRate=" + interestRate + "]"; 
} 
3 


Now a savings account is converted to a string such as SavingsAccount[balance= 
10000] [interestRate=5]. The brackets show which fields belong to the superclass. 


The equals method is called whenever you want to compare whether 
two objects have the same contents: 


if (coinl.equals(coin2)) 
// Contents are the same—see Figure 9 


This is different from the test with the == operator, which tests whether the two ref- 
erences are to the same object: 


if (coinl == coin2) : 
// Objects are the same—see Figure 10 


025 | 
quarter" | 


Figure 9 Two References to Equal Objects 
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coinl 


coin2 = 


Figure 10 Two References to the Same Object 


Let us implement the equals method for the Coin class. You need to override the 
equals method of the Object class: 


public class Coin 


{ 
public boolean equals(Object otherObject) 
{ 
} 

} 


Now you have a slight problem. The Object class knows nothing about coins, so it 
defines the otherObject parameter of the equals method to have the type Object. 
When redefining the method, you are not allowed to change the object signature. 
Cast the parameter to the class Coin: 


Coin other = (Coin) otherObject; 
Then you can compare the two coins. 


public boolean equals(Object otherObject) 


{ 
Coin other = (Coin) otherObject; 
return name.equals(other.name) 
&& value == other.value; 


} 


Note that you must use equals to compare object fields, but use == to compare 
number fields. 

When you override the equals method, you should also override the hashCode 
method so that equal objects have the same hash code—see Chapter 16 for details. 


SELF CHECK 


16. Should the call x.equals(x) always return true? 
17. Can you implement equals in terms of toString? Should you? 
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COMMON ERROR 10.6 


Defining the equals Method with the Wrong Parameter Type 


Consider the following, seemingly simpler, version of the equals method for the Coin class: 


public boolean equals(Coin other) // Don’t do this! 
{ 


return name.equals(other.name) && value == other.value; 


Here, the parameter of the equals method has the type Coin, not Object. 
Unfortunately, this method does not override the equals method in the Object class. 
Instead, the Coin class now has two different equals methods: 


boolean equals(Coin other) // Defined in the Coin class 
boolean equals(Object otherObject) // Inherited from the Object class 


This is error-prone because the wrong equals method can be called. For example, consider 
these variable definitions: 


Coin aCoin = new Coin(0.25, "“quarter"); 
Object anObject = new Coin(0.25, “quarter”); 


The call aCoin. equals (anObject) calls the second equals method, which returns false. 
The remedy is to ensure that you use the Object type for the explicit parameter of the 
equals method. 


ADVANCED Topic 10.5 


inheritance and the equals Method 


You just saw how to write an equals method: Cast the otherObject parameter to the type of 
your class, and then compare the fields of the implicit parameter and the other parameter. 

But what if someone called coin1.equals(x) where x wasn’t a Coin object? Then the bad 
cast would generate an exception, and the program would die. Therefore, you first want to 
test whether otherObject really is an instance of the Coin class. The easiest test would be 
with the instanceof operator. However, that test is not specific enough. It would be possible 
for otherObject to belong to some subclass of Coin. To rule out that possibility, you should 
test whether the two objects belong to the same class. If not, return false. 


if (getClass(Q) != otherObject.getClass()) return false; 


Moreover, the Java language specification [1] demands that the equals method return false 
when otherObject is null. 
Here is an improved version of the equals method that takes these two points into account: 


public boolean equals(Object otherObject) 
{ 
if (otherObject == null) return false; 
if (getClass() != otherObject.getClass()) 
return false; 


Coin other = (Coin) otherObject; 
return name.equals(other.name) && value == other.value; 
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} 
When you define equals in a subclass, you should first call equals in the superclass, like this: 


public CollectibleCoin extends Coin 


{ 
nubr ic boolean equals(Object otherObject) 
if (!super.equals(otherObject)) return false; 
CollectibleCoin other = (CollectibleCoin) otherObject; 
return year == other.year; 
} 


private int year; 


You know that copying an object reference simply gives you two references to the 
same object: ! 


BankAccount account = new BankAccount(1000) ; 
BankAccount account2 = account; 
account2.deposit(500) ; 
// Now both account and account2 refer to a bank account with a balance of 1500 


What can you do if you actually want to make a copy of an object? 
That is the purpose of the clone method. The clone method must 
return a mew object that has an identical state to the existing object 
(see Figure 11). 


Figure 11 
Cloning Objects 
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Implementing the clone method is quite a bit more difficult than implementing 
the toString or equals methods—see Advanced Topic 10.6 for details. 

Let us suppose that someone has implemented the clone method for the Bank- 
Account class. Here is how to call it: 


BankAccount clonedAccount = (BankAccount) account.clone() ; 


The return type of the clone method is the class Object. When you call the method, 
you must use a cast to convince the compiler that account.clone() really has the 
same type as clonedAccount. 


COMMON ERROR 10.7 


Forgetting to Clone 


In Java, object fields contain references to objects, not actual objects. This can be convenient 
for giving two names to the same object: 


BankAccount harrysChecking = new BankAccount() ; 
BankAccount slushFund = harrysChecking; 

// Use Harry’s checking account for the slush fund 
slushFund. deposit (80000) 

// A lot of money ends up in Harry’s checking account 


However, if you don’t intend two references to refer to the same object, then this is a prob- 
lem. In that case, you should use the clone method: 


BankAccount slushFund = (BankAccount) harrysChecking.cloneQ) ; 


QUALITY Tip 10.1 


Clone Mutable Instance Fields in Accessor Methods 


Consider the following class: 


public class Customer 


{ 
public Customer(String aName) 
{ 
name = aName; 
account = new BankAccount() ; 
5 
public String getName() 
{ 
return name; 
} 


public BankAccount getAccount() ; 
{ 


return account; 
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} 


private String name; 
private BankAccount account; 


} 


This class looks very boring and normal, but the getAccount method has a curious property. 
It breaks encapsulation, because anyone can modify the object state without going through 
the public interface: 


Customer harry = new Customer("Harry Handsome") ; 
BankAccount account = harry.getAccount(); 

// Anyone can withdraw money! 
account.withdraw(100000) ; 


Maybe that wasn’t what the designers of the class had in mind? Maybe they wanted class 
users only to inspect the account? In such a situation, you should clone the object reference: 


public BankAccount getAccount() ; 
{ 


return (BankAccount) account.clone(); 


} 


Do you also need to clone the getName method? No—that method returns a string, and 
strings are immutable. It is safe to give out a reference to an immutable object. 


ADVANCED TOoPic 10.6 


Implementing the clone Method 


The Object.clone method is the starting point for the clone methods in your own classes. It 
creates a new object of the same type as the original object. It also automatically copies the 
instance fields from the original object to the cloned object. Here is a first attempt to imple- 
ment the clone method for the BankAccount class: 


public class BankAccount 


{ 
public Object clone() 
{ 
// Not complete 
Object clonedAccount = super.clone(); 
return clonedAccount; 
} 
; 


However, this Object.clone method must be used with care. It only shifts the problem of 
cloning by one level; it does not completely solve it. Specifically, if an object contains a refer- 
ence to another object, then the Object.clone method makes a copy of that object reference, 
not a clone of that object. The figure below shows how the Object.clone method works 
with a Customer object that has references to a String object and a BankAccount object. As 
you can see, the Object.clone method copies the references to the cloned Customer object 
and does not clone the objects to which they refer. Such a copy is called a shallow copy. 
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The Object.clone Method Makes a Shallow Copy 


There is a reason why the Object.clone method does not systematically clone all sub- 
objects. In some situations, it is unnecessary. For example, if an object contains a reference to 
a string, there is no harm in copying the string reference, because Java string objects can 
never change their contents. The Object.clone method does the right thing if an object 
contains only numbers, Boolean values, and strings. But it must be used with caution when 
an object contains references to other objects. 

For that reason, there are two safeguards built into the Object.clone method to ensure 
that it is not used accidentally. First, the method is declared protected (see Advanced Topic 
10.3). This prevents you from accidentally calling x.clone if the class to which x belongs 
hasn’t redefined clone to be public. 

As a second precaution, Object.clone checks that the object being cloned implements the 
Cloneable interface. If not, it throws an exception. The Object.clone method looks like this: 


public class Object 


{ 
protected Object clone() 
throws CloneNotSupportedException 
af 
if (this instanceof Cloneable) 
{ 
// Copy the instance fields 
} 
else 
throw new CloneNotSupportedException() ; 
} 
} 


Unfortunately, all that safeguarding means that the legitimate callers of Object.clone() pay a 
price—they must catch that exception even if their class implements Cloneable. 


public class BankAccount implements Cloneable 


{ 
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public Object clone() 


{ 
try 
{ 
return super.clone(); 
} 
catch (CloneNotSupportedException e) 
1 
// Can’t happen because we implement Cloneable but we still must catch it. 
return null; 
} 
} 


If an object contains a reference to another mutable object, then you must call clone for that 
reference. For example, suppose the Customer class has an instance field of class Bank- 
Account. You can implement Customer .clone as follows: 


public class Customer implements Cloneable 


{ 
public Object clone() 
: 
cry 
{ 
Customer cloned = (Customer) super.clone(); 
cloned.account = (BankAccount) account.cloneQ(); 
return cloned; 
} 
catch(CloneNotSupportedException e) 
{ 
// Can’t happen because we implement Cloneable 
return null; 
} 
} 


private String name; 
private BankAccount account; 


ADVANCED Topic 10.7 


Enumerated Types Revisited 


In Advanced Topic 5.3, we introduced the concept of an enumerated type: a type with a 
finite number of values. An example is 


public enum FilingStatus { SINGLE, MARRIED } 


In Java, enumerated types are classes with special properties. They have a finite number of 
instances, namely the objects defined inside the braces. For example, there are exactly two 
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objects of the FilingStatus class: FilingStatus.SINGLE and FilingStatus.MARRIED. Since 
FilingStatus has no public constructor, it is impossible to construct additional objects. 

Enumeration classes extend the Enum class, from which they inherit toString and clone 
methods. The toString method returns a string that equals the object’s name. For example, 
FilingStatus.SINGLE.toString() returns "SINGLE". The clone method returns the given 
object without making a copy. After all, it should not be possible to generate new objects of 
an enumeration class. 

The Enum class inherits the equals method from its superclass, Object. Thus, two enumer- 
ation constants are only considered equal when they are identical. 

You can add your own methods and constructors to an enumeration class, for example 


public enum CoinType 


{ 
PENNY(O.01), NICKEL(O.05), DIMECO.1), QUARTER(O.25); 
CoinType(double aValue) { value = aValue; } 
public double getValue() { return value; } 
private double value; 
5 


This CoinType class has exactly four instances: CoinType.PENNY, CoinType.NICKEL, Coin- 
Type.DIME, and CoinType. QUARTER. If you have one of these four CoinType objects, you can 
apply the getValue method to obtain the coin’s value. 

Note that there is a major philosophical difference between this CoinType class and the 
Coin class that we have discussed elsewhere in this chapter. A Coin object represents a partic- 
ular coin. You can construct as many Coin objects as you like. Different Coin objects can be 
equal to another. We consider two Coin objects equal when their names and values match. 
However, CoinType describes a type of coins, not an individual coin. The four CoinType 
objects are distinct from each other. 


RANDOM FACT 10.1 


Scripting Languages 


Suppose you work for an office where you must help with the bookkeeping. Suppose that 
every sales person sends in a weekly spreadsheet with sales figures. One of your jobs is to 
copy and paste the individual figures into a master spreadsheet and then copy and paste the 
totals into a word processor document that gets e-mailed to several managers. This kind of 
repetitive work can be intensely boring. Can you automate it? 

It would be a real challenge to write a Java program that can help you—you’d have to 
know how to read a spreadsheet file, how to format a word processor document, and how to 
send e-mail. 

Fortunately, many office software packages include scripting languages. These are pro- 
gramming languages that are integrated with the software for the purpose of automating 
repetitive tasks. The best-known of these scripting languages is Visual Basic Script, which is a 
part of the Microsoft Office suite. The Macintosh operating system has a language called 
AppleScript for the same purpose. 

In addition, scripting languages are available for many other purposes. JavaScript is used 
for web pages. (There is no relationship between Java and JavaScript—the name JavaScript 
was chosen for marketing reasons.) Tcl (short for “tool control language” and pronounced 
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File Edit Yiew Terminal Tabs Help 

~$ jrunscript | 
js> importPackage (Packages. javax.swing); | 
js> frame = new JFrame(); | 
javax swing, JFrame[frameO,0,0,0x0,invalid, hidden, Layout=java.awt BorderLayout, ti 
tle=, resizable ,normal, defaultCloseOperations=HIDE. ON_CLOSE, rootPane=javax swing. J 
RootPane[ ,0,0,0x0, invalid, Layout=javax swing, JRootPane$RootLayout , alignmentX=0 0 
,alignmentY=0,0,border=, flags=16777673 , maximumSize=,minimumSize=, preferredSize=) 

, FootPaneCheck ingEnabled=t rue] | 
js> label = new JLabel("Hello, World"); | 
javax swing, JLabel[,0,0,0x0, invalid, alignmentX=0.0,alignmentY=0,0, borders, flags= 
8388608 , maximumSize=, mindmumSizes, preferredSizes, defaulticon=,disablediIcon=,hori 
zontalALignment#LEADING ,horizontalTextPosition=TRAILING, iconTextGap=4, LabelFor=, 
textsHello, World, verticalAlignment=CENTER, verticalTextPosition=CENTER) | 
js» frame. add(label) ; 

javax swing. JLabel[,0,0,0x0,invalid, alignmentX=0 0, alignmentY=0 0 borders, flags= 
8388608, maximumSizes, minimumSizes,preferredSize= defaultIcon=,¢ ab LedIcons,hord 
zontalALignment=LEADING, horizontalTextPosition=Th| Te 1 Kh, LabetFors,, 
textsHello, World, verticalAlignment=CENTER, vertie ITER) 

js» frame.setSize(200, 100); 

js* frame setVisible(true) ; 

js* || 


Scripting Java Classes with JavaScript 


“tickle”) is an open source scripting language that has been ported to many platforms and is 
often used for scripting software test procedures. Shell scripts are used for automating soft- 
ware configuration, backup procedures, and other system administration tasks. 

Scripting languages have two features that makes them easier to use than full-fledged pro- 
gramming languages such as Java. First, they are interpreted. The interpreter program reads 
each line of program code and executes it immediately without compiling it first. That makes 
experimenting much more fun—you get immediate feedback. Also, scripting languages are 
usually loosely typed, meaning you don’t have to declare the types of variables. Every vari- 
able can hold values of any type. For example, the Scripting Java Classes with JavaScript fig- 
ure shows a scripting session with the JavaScript implementation that is included in Java 6. 
This version of JavaScript allows you to manipulate Java objects. The script stores frame and 
label objects in variables that are declared without types. It then calls methods that are exe- 
cuted immediately, without compilation. The frame pops up as soon as the line with the set- 
Visible command is entered. (If you use an earlier version of Java, you can achieve the same 
effect with the Rhino scripting engine. You can download Rhino from the Mozilla web site 
[2]). In recent years, authors of computer viruses have discovered how scripting languages 
simplify their lives. The famous “love bug” is a Visual Basic Script program that is sent as an 
attachment to an e-mail. The e-mail has an enticing subject line “I love you” and asks the 
recipient to click on an attachment masquerading as a love letter. In fact, the attachment is a 
script file that is executed when the user clicks on it. The script creates some damage on the 
recipient’s computer and then, through the power of the scripting language, uses the Out- 
look e-mail client to mail itself to all addresses found in the address book. Try programming 
that in Java! By the way, the person suspected of authoring that virus was a student who had 
submitted a proposal to write a thesis researching how to write such programs. Perhaps not 
surprisingly, the proposal was rejected by the faculty. 
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Why do we still need Java if scripting is easy and fun? Scripts often have poor error 
checking and are difficult to adapt to new circumstances. Scripting languages lack many of 
the structuring and safety mechanisms (such as classes and type checking by the compiler) 
that are important for building robust and scalable programs. 


As you add more user interface components to a frame, the frame 
can get quite complex. Your programs will become easier to under- 
stand when you use inheritance for complex frames. 

Design a subclass of JFrame. Store the components as instance 
fields. Initialize them in the constructor of your subclass. If the initialization code 
gets complex, simply add some helper methods. 

Here, we carry out this process for the investment viewer program in Chapter 9. 


public class InvestmentFrame extends JFrame 


{ 

public InvestmentFrame() 

{ 
account = new BankAccountCINITIAL_BALANCE) ; 
// Use instance fields for components 
label = new JLabel("balance: " + account.getBalance()); 
// Use helper methods 
createButton(); 
createPanel(); 
setSizeCFRAME_ WIDTH, FRAME HEIGHT); 

} 

private void createButton() 

{ 
ActionListener listener = new AddInterestListener(); 
button.addActionListener(listener) ; 
button = new JButtonC"Add Interest"); 

} 

private void createPanel () 

{ 
panel = new JPanel(); 
panel .add(button) ; 
panel .add(label) ; 
add(panel); 

} 


private JButton button; 
private JLabel label; 
private JPanel panel; 
private BankAccount account; 
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} 


This approach differs from the programs in Chapter 9. In those programs, we sim- 
ply configured the frame in the main method of a viewer class. 

It is a bit more work to provide a separate class for the frame. However, the 
frame class makes it easier to organize the code that constructs the user-interface 
elements. We will use this approach for all examples in this chapter. 

Of course, we still need a class with a main method: 


public class InvestmentViewer2 


{ 
public static void main(String[] args) 
{ 
JFrame frame = new InvestmentFrame() ; 
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
frame.setVisible(true) ; 
} 
} 
SELF CHECK 


18. How many Java source files are required by the investment viewer application 
when we use inheritance to define the frame class? 


19. Why does the InvestmentFrame constructor call setSize(FRAME_WIDTH, 
FRAME_HEIGHT), whereas the main method of the investment viewer class in 
Chapter 9 called frame.setSize(FRAME_WIDTH, FRAME HEIGHT) ? 


ADVANCED Topic 10.8 


Adding the main Method to the Frame Class 


Have another look at the InvestmentFrame and InvestmentViewer2 classes. Some program- 
mers prefer to combine these two classes, by adding the main method to the frame class: 


public class InvestmentFrame extends JFrame 


{ 


public static void main(String[] args) 


{ 
JFrame frame = new InvestmentFrame() ; 
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
frame.setVisible(true) ; 


} 


public InvestmentFrame() 


{ 
account = new BankAccountCINITIAL_BALANCE) ; 


// Use instance fields for components 
label = new JLabel("balance: " + account.getBalance()); 
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// Use helper methods 
createButton() ; 
createPanel(); 


setSize(FRAME_WIDTH, FRAME_HEIGHT) ; 


} 


This is a convenient shortcut that you will find in many programs, but it does muddle the 
responsibilities between the frame class and the program. Therefore, we do not use this 
approach in this book. 


U Processing Text Input LULL 


A graphical application can receive text input by calling the showInputDialog method 
of the JoptionPane class, but popping up a separate dialog box for each input is not a 
natural user interface. Most graphical programs collect text input through text fields 
(see Figure 12). In this section, you will learn how to add text fields to a graphical 
application, and how to read Sethe ase: types into them. 

The JTextField class provides a text field. When you construct a 
text field, you need to supply the width—the approximate number of 
characters that you expect the user to type. 


Use JTextField | 
components to provide _ 
space for user input. Place | 
a JLabel next to each text final int FIELD_WIDTH = 10; 
field. a final JTextField rateField = new JTextField(FIELD_WIDTH) ; 
— Users can type additional characters, but then a part of the contents 
of the field becomes invisible. 
You will want to label each text field so that the user knows what to type into it. 
Construct a JLabel object for each label: 


JLabel rateLabel = new JLabel("Interest Rate: "); 


You want to give the user an opportunity to enter all information into the text fields 
before processing it. Therefore, you should supply a button that the user can press 
to indicate that the input is ready for processing. 

When that button is clicked, its actionPerformed method reads the user input 
from the text fields, using the getText method of the JTextField class. The getText 


Interest Rate: 5.0 |Add Interest | balance: 1000.0 


i 


Figure 12 An Application with a Text Field 


10.10 = Processing Text Input GraPHics TRack 481] 


method returns a String object. In our sample program, we turn the string into a 
number, using the Double. parseDouble method: 


class AddiInterestListener implements ActionListener 


{ 
public void actionPerformed(ActionEvent event) 
{ 
double rate = Double.parseDouble(rateField.getText()); 
} 
} 


The following application is a useful prototype for a graphical user-interface front 
end for arbitrary calculations. You can easily modify it for your own needs. Place 
other input components into the frame. Change the contents of the actionPerformed 
method to carry out other calculations. Display the result in a label. 


ch10/textfield/InvestmentViewer3.java 
import javax.swing.JFrame; 


4, 3, 
RE 


This program displays the growth of an investment. 


public class InvestmentViewer3 


1 
Z 
3 
4 
5 */ 
6 
7 
8 
2 


{ 
public static void main(String[] args) 
{ 
10 JFrame frame = new InvestmentFrame() ; 
11 frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
12 frame.setVisible(true); 
13 } 


1 import java.awt.event.ActionEvent; 

2 import java.awt.event.ActionListener; 

3 import javax.swing.JButton; 

4 import javax.swing.JFrame; 

5) ~=6import javax.swing.JLabel; 

6 import javax.swing. JPanel; 

7 import javax.swing.JTextField; 

8 

9 
10 


rab d 


A frame that shows the growth of an investment with variable interest. 


ll */ 

12 public class InvestmentFrame extends JFrame 

13 { 

14 public InvestmentFrame() 

15 { 

16 account = new BankAccount(CINITIAL_BALANCE) ; 
17 

18 // Use instance fields for components 


19 resultLabel = new JLabel("balance: " + account.getBalance()); 
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20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 


// Use helper methods 
createTextFieldQ); 
createButton(); 
createPanel(); 


setSizeCFRAME_WIDTH, FRAME_HEIGHT); 


private void createTextField() 


rateLabel new JLabelC("Interest Rate: ; 


final int FIELD_WIDTH = 10; 
rateField = new JTextField(FIELD WIDTH) ; 
rateField.setText("" + DEFAULT RATE); 


private void createButton() 
button = new JButton("Add Interest"); 
class AddInterestListener implements ActionListener 
public void actionPerformed(ActionEvent event) 


double rate = Double.parseDoub1e( 
rateField.getTextQ); 
double interest = account.getBalance() 

* rate / 100; 
account.deposit(interest) ; 
resultLabel.setText( 

“balance: " + account.getBalance()); 


ActionListener listener = new AddInterestListener(); 
button.addActionListener(listener); 


private void createPanel 


panel = new JjPanel(); 
panel .add(rateLabel); 
panel.add(rateField); 
panel .add(button) ; 
panel.add(CresultLabel); 
add(panel); 


private JLabel rateLabel; 
private JTextField rateField; 
private JButton button; 
private JLabel resultLabel; 
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74 private JPanel panel; 

75 private BankAccount account; 

76 

if private static final int FRAME_WIDTH = 500; 

78 private static final int FRAME HEIGHT = 200; 

79 

80 private static final double DEFAULT_RATE = 5; 

81 private static final double INITIAL_BALANCE = 1000; 
82 } 

SELF CHECK 


20. What happens if you omit the first JLabel object? 


21. Ifa text field holds an integer, what expression do you use to read its contents? 


In Section 10.10, you saw how to construct text fields. A text field 
holds a single line of text. To display multiple lines of text, use the 
JTextArea class. 

When constructing a text area, you can specify the number of rows and columns: 


final int ROWS = 10; 

final int COLUMNS = 30; 

JTextArea textArea = new JTextAreaC(ROWS, COLUMNS) ; 
Use the setText method to set the text of a text field or text area. The append method 
adds text to the end of a text area. Use newline characters to separate lines, like this: 


textArea.append(account.getBalance() + "\n"); 


If you want to use a text field or text area for display purposes only, call the set- 
Editable method like this 


textArea.setEditable(false); 


Now the user can no longer edit the contents of the field, but your program can still 
call setText and append to change it. 

As shown in Figure 4, the JTextField and JTextArea classes are subclasses of the 
class JTextComponent. The methods setText and setEditable are defined in the JTex- 
tComponent class and inherited by JTextField and JTextArea. However, the append 
method is defined in the JTextArea class. 

To add scroll bars to a text area, use a JScrol1Pane, like this: 


JTextArea textArea = new JTextAreaCROWS, COLUMNS) ; 
JScrollPane scrollPane = new JScroll]Pane(textArea) ; 


Then add the scroll pane to the panel. Figure 13 shows the result. 
The following sample program puts these concepts together. A user can enter 
numbers into the interest rate text field and then click on the “Add Interest” button). 


484 CHAPTER TO «# Inheritance GRAPHICS TRACK 


Interest Rate: 5.0 | Add Interest 


1050.0 


be 


1102.5 

11157. 625 

11215. 50625 

11276. 2815624999998 


'1340.0956406249998 

1407.1004226562497 

(1477.455443 7890622 
282159 


Figure 13. The Investment Application with a Text Area 


The interest rate is applied, and the updated balance is appended to the text area. 
The text area has scroll bars and is not editable. 

This program is similar to the previous investment viewer program, but it keeps 
track of all the bank balances, not just the last one. 


ch10/textarea/InvestmentFrame.java 


import java.awt.event.ActionEvent; 
import java.awt.event.ActionListener; 


1 

2 

3 import javax. 
4 import javax. 
5) ~=6import javax. 
6 import javax. 
7 import javax. 
8 import javax. 
9 import javax. 


swing. JButton; 
Swing. JFrame; 
swing. JLabel; 
Swing. JPanel; 
swing.JScrol1]Pane; 
Swing. JTextArea; 
swing.JTextField; 


10 

ll /* * 

12 A frame that shows the growth of an investment with variable interest. 
13 */ 

14 public class InvestmentFrame extends JFrame 

15 { 

16 public InvestmentFrame() 

17 { 

18 account = new BankAccount(INITIAL_BALANCE) ; 
19 resultArea = new JTextArea(AREA_ROWS, AREA_COLUMNS): 
20 resultArea.setEditable(false); 

21 

22 // Use helper methods 

23 createTextField(); 

24 createButton() ; 

25 createPanel(); 

26 

27 setSizeCFRAME_WIDTH, FRAME HEIGHT) ; 

28 } 

29 

30 private void createTextField() 

31 { 

32 rateLabel = new JLabel("Interest Rate: "); 
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final int FIELD WIDTH = 10; 
rateField = new JTextField(FIELD WIDTH) ; 
rateField.setText(' + DEFAULT_RATE) ; 


} 


private void createButton() 


button = 


new JButton("Add Interest"); 


class AddInterestListener implements ActionListener 


public void actionPerformed(ActionEvent event) 


{ 


} 


ActionListener listener = 


double rate = Double.parseDouble( 
rateField.getTextQ); 
double jnterest = account.getBalance() 
rate / 100; 
account.deposit(interest) ; 
resultArea.append(account.getBalance() + °\n'); 


new AddInterestListenerQ() ; 


button. addActionListener(listener) ; 


} 


private void createPanel() 


{ 


panel = new jPanel(); 
panel .add(rateLabel) ; 
panel.add(rateField) ; 
panel .add(button) ; 


JScrollPane scrollPane = 


new JScrollPane(resultArea) ; 


panel .add(scrol1Pane) ; 
add(panel); 


} 


private 
private 
private 
private 
private 
private 


private 
private 


private 
private 


private 
private 


JLabel rateLabel; 
JTextField rateField; 
jJButton button; 
JTextArea resultArea; 
JPanel panel; 
BankAccount account; 


static final 
etaric Tina! 


int FRAME WIDTH = “00; 
int FRAME HEIGHT = 250; 


Static fina! 
static Tina! 


int AREA_ROWS = 10; 
int AREA COLUMNS = 30; 


static final 
static final 


double DEFAULT_RATE = 9; 
double INITIAL. BALANCE = 1000; 
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SELF CHECK 


22. What is the difference between a text field and a text area? 
23. Why did the InvestmentFrame program call resultArea.setEditable(false)? 


24. How would you modify the InvestmentFrame program if you didn’t want to use 
scroll bars? 


How To 10.1 


Implementing a Graphical User Interface (GUI) 


A GUI program allows users to supply inputs and specify actions. The InvestmentViewer3 
program has only one input and one action. More sophisticated programs have more inter- 
esting user interactions, but the basic principles are the same. 


Step 1 Enumerate the actions that your program needs to carry out. 


For example, the investment viewer has a single action, to add interest. Other programs may 
have different actions, perhaps for making deposits, inserting coins, and so on. 


Step 2 For each action, enumerate the inputs that you need. 


For example, the investment viewer has a single input: the interest rate. Other programs may 
have different inputs, such as amounts of money, product quantities, and so on. 


Step 3. For each action, enumerate the outputs that you need to show. 


The investment viewer has a single output: the current balance. Other programs may show 
different quantities, messages, and so on. 


Step 4 Supply the user interface components. 


Right now, you need to use buttons for actions, text fields for inputs, and labels for outputs. 
In Chapter 18, you will see many more user-interface components that can be used for 
actions and inputs. In Chapter 3, you learned how to implement your own components to 
produce graphical output, such as charts or drawings. 

Add the required buttons, text fields, and other components to a frame. In this chapter, 
you have seen how to lay out very simple user interfaces, by adding all components to a sin- 
gle panel and adding the panel to the frame. Chapter 18 shows you how you can achieve 
more complex layouts. 


Step 5 Supply event handler classes. 


For each button, you need to add an object of a listener class. The listener classes must 
implement the ActionListener interface. Supply a class for each action (or group of related 
actions), and put the instructions for the action in the actionPerformed method. 


class ButtonlListener implements ActionListener 


{ 
public void actionPerformed(ActionEvent event) 
{ 
// button action goes here 
} 


10.11 # Text Areas GRAPHICS TRACK 487 


Remember to declare any local variables accessed by the listener methods as final. 
Step 6 Make listener objects and attach them to the event sources. 


For action events, the event source is a button or other user-interface component, or a timer. 
You need to add a listener object to each event source, like this: 


ActionListener listenerl = new ButtonlListener(); 
buttonl.addActionListener(listener1) ; 


COMMON ERROR 10.8 
By Default, Components Have Zero Width and Height 


The sample GUI programs of this chapter display results in a label or text area. Sometimes, 
you want to use a graphical component such as a chart. You add the chart component to the 
panel: 


panel .add(textField) ; 
panel .add(button) ; 
panel .add(chartComponent) ; 


However, the default size for a component is 0 by 0 pixels, and the chart component will not 
be visible. The remedy is to call the setPreferredSize method, like this: 


chartComponent.setPreferredSize(new Dimension(CHART_WIDTH, CHART_HEIGHT)) ; 


GUI components such as buttons and text fields know how to compute their preferred size, 
but you must set the preferred size of components on which you paint. 


PRODUCTIVITY HINT 10.2 
Code Reuse 


Suppose you are given the task of writing another graphical user-interface program that 
reads input from a couple of text fields and displays the result of some calculations in a label 
or text area. You don’t have to start from scratch. Instead, you can—and often should—reuse 
the outline of an existing program, such as the foregoing InvestmentFrame class. 

To reuse program code, simply make a copy of a program file and give the copy a new 
name. For example, you may want to copy InvestmentFrame.java to a file TaxReturn- 
Frame. java. Then remove the code that is clearly specific to the old problem, but leave the 
outline in place. That is, keep the panel, text field, event listener, and so on. Fill in the code 
for your new calculations. Finally, rename classes, buttons, frame ttles, and so on. 

Once you understand the principles behind event listeners, frames, and panels, there is no 
need to rethink them every time. Reusing the structure of a working program makes your 
work more efficient. 

However, reuse by “copy and rename” is still a mechanical and somewhat error-prone 
approach. It is even better to package reusable program structures into a set of common 
classes. The inheritance mechanism lets you design classes for reuse without copy and paste. 
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CHAPTER SUMMARY 


1. Inheritance is a mechanism for extending existing classes by adding methods 


and fields. 


2. The more general class is called a superclass. The more specialized class that 
inherits from the superclass 1s called the subclass. 


3. Every class extends the Object class either directly or indirectly. 


4. Inheriting from a class differs from implementing an interface: The subclass 
inherits behavior and state from the superclass. 


5. One advantage of inheritance is code reuse. 


6. When defining a subclass, you specify added instance fields, added methods, 


and changed or overridden methods. 
7. Sets of classes can form complex inheritance hierarchies. 
8. A subclass has no access to private fields of its superclass. 
9. Use the super keyword to call a method of the superclass. 


10. ‘To call the superclass constructor, you use the super keyword in the first 
statement of the subclass constructor. 


11. Subclass references can be converted to superclass references. 

12. The instanceof operator tests whether an object belongs to a particular type. 
13. An abstract method is a method whose implementation is not specified. 

14. An abstract class is a class that cannot be instantiated. 


15. A field or method that is not declared as public, private, or protected can be 
accessed by all classes in the same package, which is usually not desirable. 


16. Protected features can be accessed by all subclasses and all classes in the same 


package. 


* 


17. Define the toString method to yield a string that describes the object state. 
18 
19 
20 


Define the equals method to test whether two objects have equal state. 


The clone method makes a new object with the same state as an existing object. 


se 


Define a JFrame subclass for a complex frame. 


21. Use JTextField components to provide space for user input. Place a JLabel next 
to each text field. 


22. Use a JTextArea to show multiple lines of text. 


23 


« 


You can add scroll bars to any component with a JScro11Pane. 


o. 
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FURTHER READING 


1. James Gosling, Bill Joy, Guy Steele, and Gilad Bracha, The Java Language Specification, 
3rd edition, Addison-Wesley, 2005. 


2. http://ww.mozilla.org/rhino The Rhino interpreter for the JavaScript language. 


CLASSES, OBJECTS, AND METHODS 
INTRODUCED IN THIS CHAPTER 


java.awt.Component 

setPreferredSize 
java.awt.Dimension 
java. lang.Cloneable 
java. lang.CloneNotSupportedException 
java.lang.Object 

clone 

toString 
javax.swing.JTextArea 

append 
javax.swing.JTextField 
javax.swing.text.JTextComponent 

getText 

isEditable 

setEditable 

setText 


REVIEW EXERCISES 


Exercise R10.1. What is the balance of b after the following operations? 


SavingsAccount b = new SavingsAccount (10) ; 
b.deposit(5000) ; 

b.withdraw(b.getBalance() / 2); 
b.addInterestQ); 


Exercise R10.2. Describe all constructors of the SavingsAccount class. List all meth- 
ods that are inherited from the BankAccount class. List all methods that are added to 
the SavingsAccount class. 


Exercise R10.3. Can you convert a superclass reference into a subclass reference? A 
subclass reference into a superclass reference? If so, give examples. If not, explain 
why not. 
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xx Exercise R10.4. Identify the superclass and the subclass in each of the following pairs 
of classes. 
a. Employee, Manager 
. Polygon, Triangle 
. GraduateStudent, Student 


. Person, Student 


b 
d 
e. Employee, GraduateStudent 
f. BankAccount, CheckingAccount 
g. Vehicle, Car 

h. Vehicle, Minivan 

i. Car, Minivan 


j. Truck, Vehicle 


* Exercise R10.5. Suppose the class Sub extends the class Sandwich. Which of the 
following assignments are legal? 


Sandwich x = new Sandwich(); 
Sub y = new Sub(); 


a. X = y; c. y = new Sandwich(); 
b. y = x; d. x = new SubQ); 


* Exercise R10.6. Draw an inheritance diagram that shows the inheritance relation- 
ships between the classes: 


® Person * Instructor 
® Employee ® Classroom 
© Student ® Object 


*k* Exercise R10.7. In an object-oriented traffic simulation system, we have the follow- 
ing classes: 


® Vehicle ® PickupTruck 

® Car ® SportUti lityVehicle 
® Truck ® Minivan 

® Sedan ® Bicycle 

® Coupe ® Motorcycle 


Draw an inheritance diagram that shows the relationships between these classes. 
wx Exercise R10.8. What inheritance relationships would you establish among the 
following classes? 
® Student 
® Professor 
® TeachingAssistant 


® Employee 
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® Secretary 
® DepartmentChair 
e Janitor 
® SeminarSpeaker 
® Person 
® Course 
® Seminar 
® Lecture 
® ComputerLab 
*k*&* Exercise R10.9. Which of these conditions returns true? Check the Java documenta- 
tion for the inheritance patterns. 
a. Rectangle r = new Rectangle(5, 10, 20, 30); 
b. if (r instanceof Rectangle) 
c. 1f (Cr instanceof Point) 
d. if (r instanceof Rectangle2D.Double) 
e. if Cr instanceof RectangularShape) 
f. if (r instanceof Object) 
g. if Cr instanceof Shape) 


** Exercise R10.10. Explain the two meanings of the super keyword. Explain the two 
meanings of the this keyword. How are they related? 


kee Exercise R10.11. (Tricky.) Consider the two calls 


public class D extends B 


public void f() 
this.gQ; // 1 
Brae void gQ) 
super.gQ); // 2 
} 

_ 


Which of them is an example of polymorphism? 
kk Exercise R10.12. Consider this program: 


public class AccountPrinter 
c 
public static void main(String[] args) 
{ 
SavingsAccount momsSavings 
= new SavingsAccount(0.5); 
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CheckingAccount harrysChecking 
= new CheckingAccount (0) ; 


endOfMonth(momsSavings) ; 
endOfMonth(CharrysChecking) ; 
printBalance(momsSavings) ; 
printBalanceCharrysChecking) ; 


} 
public static void endOfMonth(SavingsAccount savings) 
{ 

Savings.addInterestQ) ; 
} 
public static void endOfMonth(CheckingAccount checking) 
{ 

checking.deductFees() ; 
} 
public static void printBalance(BankAccount account) 
{ 

System.out.printInC"The balance is $" 

+ account.getBalanceQ)); 

} 


} 


Are the calls to the endofMonth methods resolved by early binding or late binding? 
Inside the printBalance method, is the call to getBalance resolved by early binding 
or late binding? 


Exercise R10.13. Explain the terms shallow copy and deep copy. 


Exercise R10.14. What access attribute should instance fields have? What access 
attribute should static fields have? How about static final fields? 


Exercise R10.15. What access attribute should instance methods have? Does the same 
hold for static methods? 


Exercise R10.16. The fields System. in and System. out are static public fields. Is it pos- 
sible to overwrite them? If so, how? 


Exercise R10.17. Why are public fields dangerous? Are public static fields more dan- 
gerous than public instance fields? 


Exercise R10.18. What is the difference between a label, a text field, and a text area? 


Exercise R10.19. Name a method that is defined in JTextArea, a method that 
JTextArea inherits from JTextComponent, and a method that JTextArea inherits from 
JComponent. 


Additional review exercises are available in WileyPLUS. 
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PROGRAMMING EXERCISES 


Exercise P10.1. Enhance the addInterest method of the SavingsAccount class to com- 
pute the interest on the minimum balance since the last call to addInterest. Hint: 
You need to modify the withdraw method as well, and you need to add an instance 
field to remember the minimum balance. 


Exercise P10.2. Add a TimeDepositAccount class to the bank account hierarchy. The 
time deposit account is just like a savings account, but you promise to leave the 
money in the account for a particular number of months, and there is a penalty for 
early withdrawal. Construct the account with the interest rate and the number of 
months to maturity. In the addInterest method, decrement the count of months. If 
the count is positive during a withdrawal, charge the withdrawal penalty. 


Exercise P10.3. Implement a subclass Square that extends the Rectangle class. In the 
constructor, accept the x- and y-positions of the center and the side length of the 
square. Call the setLocation and setSize methods of the Rectangle class. Look up 
these methods in the documentation for the Rectangle class. Also supply a method 
getArea that computes and returns the area of the square. Write a sample program 
that asks for the center and side length, then prints out the square (using the 
toString method that you inherit from Rectangle) and the area of the square. 


Exercise P10.4. Implement a superclass Person. Make two classes, Student and 
Instructor, that inherit from Person. A person has a name and a year of birth. A 
student has a major, and an instructor has a salary. Write the class definitions, the 
constructors, and the methods toString for all classes. Supply a test program that 
tests these classes and methods. 


Exercise P10.5. Make a class Employee with a name and salary. Make a class Manager 
inherit from Employee. Add an instance field, named department, of type String. 
Supply a method toString that prints the manager’s name, department, and salary. 
Make a class Executive inherit from Manager. Supply appropriate toString methods 
for all classes. Supply a test program that tests these classes and methods. 


Exercise P10.6. Write a superclass Worker and subclasses HourlyWorker and Salaried- 
Worker. Every worker has a name and a salary rate. Write a method computePay (int 
hours) that computes the weekly pay for every worker. An hourly worker gets paid 
the hourly wage for the actual number of hours worked, if hours is at most 40. If the 
hourly worker worked more than 40 hours, the excess is paid at time and a half. The 
salaried worker gets paid the hourly wage for 40 hours, no matter what the actual 
number of hours is. Supply a test program that uses polymorphism to test these 
classes and methods. 


Exercise P10.7. Reorganize the bank account classes as follows. In the BankAccount 
class, introduce an abstract method endOfMonth with no implementation. Rename 
the addInterest and deductFees methods into endOfMonth in the subclasses. Which 
classes are now abstract and which are concrete? Write a static method void 
test(BankAccount account) that makes five transactions and then calls endOfMonth. 
Test it with instances of all concrete account classes. 


494 CHAPTER 10 «# Inheritance 


*k*kkG Exercise P10.8. Implement an abstract class Vehicle and concrete subclasses Car and 
Truck. A vehicle has a position on the screen. Write methods draw that draw cars and 
trucks as follows: 


a 


Car Truck 


Then write a method randomVehicle that randomly generates Vehicle references, 
with an equal probability for constructing cars and trucks, with random positions. 
Call it 10 times and draw all of them. 


*G Exercise P10.9. Write a graphical application front end for a bank account class. 
Supply text fields and buttons for depositing and withdrawing money, and for 
displaying the current balance in a label. 


*G Exercise P10.10. Write a graphical application front end for an Earthquake class. 
Supply a text field and button for entering the strength of the earthquake. Display 
the earthquake description in a label. 


*G Exercise P10.11. Write a graphical application front end for a DataSet class. Supply 
text fields and buttons for adding floating-point values, and display the current 
minimum, maximum, and average in a label. 


*G Exercise P10.12. Write an application with three labeled text fields, one each for the 
initial amount of a savings account, the annual interest rate, and the number of 
years. Add a button “Calculate” and a read-only text area to display the result, 
namely, the balance of the savings account after the end of each year. 


**G Exercise P10.13. In the application from Exercise P10.12, replace the text area with a 
bar chart that shows the balance after the end of each year. 


kke*kG Exercise P10.14. Write a program that contains a text field, a button “Add Value”, 
and a component that draws a bar chart of the numbers that a user typed into the 


text field. 


**xG Exercise P10.15. Write a program that prompts the user for an integer and then 
draws as many rectangles at random positions in a component as the user requested. 


*G Exercise P10.16. Write a program that prompts the user to enter the x- and 
y-positions of the center and a radius. When the user clicks a “Draw” button, draw 
a circle with that center and radius in a component. 


**G Exercise P10.17. Write a program that allows the user to specify a circle by typing the 
radius in a text field and then clicking on the center. Note that you don’t need a 
“Draw” button. 


*k*G Exercise P10.18. Write a program that allows the user to specify a circle with two 
mouse presses, the first one on the center and the second on a point on the 


kkKG 


KG 
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periphery. Hint: In the mouse press handler, you must keep track of whether you 
already received the center point in a previous mouse press. 


Exercise P10.19. Write a program that draws a clock face with a time that the user 
enters in two text fields (one for the hours, one for the minutes). 


Hint: You need to determine the angles of the hour hand and the minute hand. The 
angle of the minute hand is easy: The minute hand travels 360 degrees in 60 minutes. 
The angle of the hour hand is harder; it travels 360 degrees in 12 x 60 minutes. 


Exercise P10.20. Write a program that asks the user to enter an integer 7, and then 
draws an n-by-n grid. 


Additional programming exercises are available in WileyPLUS. 


PROGRAMMING PROJECTS 


Project 10.1. Your task is to program robots with varying behaviors. The robots try 
to escape a maze, such as the following: 


A robot has a position and a method void move(Maze m) that modifies the position. 
Provide a common superclass Robot whose move method does nothing. Provide 
subclasses RandomRobot, RightHandRuleRobot, and MemoryRobot. Each of these robots 
has a different strategy for escaping. The RandomRobot simply makes random moves. 
The RightHandRuleRobot moves around the maze so that it’s right hand always 
touches a wall. The MemoryRobot remembers all positions that it has previously occu- 
pied and never goes back to a position that it knows to be a dead end. 


Project 10.2. Implement the toString, equals, and clone methods for all subclasses of 
the BankAccount class, as well as the Bank class of Chapter 7. Write unit tests that 
verify that your methods work correctly. Be sure to test a Bank that holds objects 
from a mixture of account classes. 
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ANSWERS TO SELF-CHECK QUESTIONS 


1. Two instance fields: balance and interestRate. 

2. deposit, withdraw, getBalance, and addInterest. 

3. Manager is the subclass; Employee is the superclass. 

4. ‘To express the common behavior of text fields and text components. 

5. We need a counter that counts the number of withdrawals and deposits. 

6. It needs to reduce the balance, and it cannot access the balance field directly. 


7, So that the count can reflect the number of transactions for the following 
month. 


8. It was content to use the default constructor of the superclass, which sets the 
balance to zero. 


9. No —this is a requirement only for constructors. For example, the Checking- 
Account.deposit method first increments the transaction count, then calls the 
superclass method. 


10. We want to use the method for all kinds of bank accounts. Had we used a 
parameter of type SavingsAccount, we couldn’t have called the method with a 
CheckingAccount object. 


11. We cannot invoke the deposit method on a variable of type Object. 

12. The object is an instance of BankAccount or one of its subclasses. 

13. The balance of a is unchanged, and the transaction count is incremented twice. 
14. Accidentially forgetting the private modifer. 

15. Any methods of classes in the same package. 

16. It certainly should—unless, of course, x is nul]. 


17. If toString returns a string that describes all instance fields, you can simply call 
toString on the implicit and explicit parameters, and compare the results. How- 
ever, comparing the fields is more efficient than converting them into strings. 


18. Three: InvestmentFrameVi ewer, InvestmentFrame, and BankAccount. 

19. The InvestmentFrame constructor adds the panel to ztself. 

20. Then the text field is not labeled, and the user will not know its purpose. 

21. Integer.parseInt(textField.getTextQ) 

22. A text field holds a single line of text; a text area holds multiple lines. 

23. The text area is intended to display the program output. It does not collect user 
input. 

24. Don’t construct a JScro11Pane and add the resu1tArea object directly to the 
frame. 
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Input/Output and 
Exception Handling 


To be able to read and write text files 
> To learn how to throw exceptions | 
To be able to design your own exception classes 


To understand the difference between checked and 
unchecked exceptions 
To learn how to catch exceptions 


To know when and where to catch an exception 


This chapter starts with a discussion of file input and output. Whenever you read or 
write data, potential errors are to be expected. A file may have been corrupted or 
deleted, or it may be stored on another computer that was just disconnected from 
the network. In order to deal with these issues, you need to know about exception 
handling. The remainder of this chapter tells you how your programs can report 
exceptional conditions, and how they can recover when an exceptional condition 


has occurred. 
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We begin this chapter by discussing the common task of reading and writing files 
that contain text. Examples are files that are created with a simple text editor, such 
as Windows Notepad, as well as Java source code and HTML files. 

The simplest mechanism for reading text is to use the Scanner class. You already 
know how to use a Scanner for reading console input. To read input from a disk file, 
first construct a FileReader object with the name of the input file, then use the 
FileReader to construct a Scanner object: 

FileReader reader = new FileReaderC"input.txt"); 

Scanner in = new Scanner(Creader) ; 

This Scanner object reads text from the file input.txt. You can use the 
Scanner methods (such as next, nextLine, nextInt, and nextDouble) to 
read data from the input file. 

To write output to a file, you construct a PrintWriter object with 
the given file name, for example 


PrintWriter out = new PrintWriterC"output.txt"); 


If the output file already exists, it is emptied before the new data are 
written into it. If the file doesn’t exist, an empty file is created. 

Use the familiar print and printin methods to send numbers, objects, and strings 
to a PrintWriter: 


out.printIn(29.95); 

out.printIln(new Rectangle(5, 10, 15, 25)); 

out.printInC"Hello, World!"); 
The print and printin methods convert numbers to their decimal string representa- 
tions and use the toString method to convert objects to strings. 
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When you are done processing a file, be sure to close the Scanner 
or PrintWriter: 


in.closeQ); 
out.close(); 


If your program exits without closing the PrintWriter, not all of the output may be 
written to the disk file. 

The following program puts these concepts to work. It reads all lines of an input 
file and sends them to the output file, preceded by line numbers. If the input file is 


Mary had a little lamb 

Whose fleece was white as snow. 
And everywhere that Mary went, 
The lamb was sure to go! 


then the program produces the output file 


/* 1 */ Mary had a little lamb 

/* 2 */ Whose fleece was white as snow. 

/* 3 */ And everywhere that Mary went, 

/* 4 */ The lamb was sure to go! 

The line numbers are enclosed in /* */ delimiters so that the program can be used 
for numbering Java source files. 

There one additional issue that we need to tackle. When the input or output file 
doesn’t exist, a FileNotFoundException can occur. The compiler insists that we tell it 
what the program should do when that happens. (In this regard, the FileNot- 
FoundException is different from the exceptions that you have already encountered. 
We will discuss this difference in detail in Section 11.3.) In our sample program, we 
take the easy way out and acknowledge that the main method should simply be ter- 
minated if the exception occurs. We label the main method like this: 


public static void main(String[] args) throws FileNotFoundException 


You will see in the following sections how to deal with exceptions in a more profes- 
sional way. 


ch11/fileio/LineNumberer.java 


1 import java.io.FileReader; 

2 import java.io.FileNotFoundException; 

3 import java.io.PrintWriter; 

4 import java.util.Scanner; 

5 

6 public class LineNumberer 

7 { 

8 public static void main(String[] args) 

9 throws FileNotFoundException 
10 { 
11 Scanner console = new Scanner(System.in); 
IZ System.out.print("Input file: "); 
13 String inputFileName = console.next(); 
14 System.out.print("Output file: "); 
15 String outputFileName = console.next(); 
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iW FileReader reader = new FileReader(CinputFi leName) ; 
18 Scanner in = new Scanner(reader) ; 

19 PrintWriter out = new PrintWriter(outputFileName) ; 
20 int lineNumber = 1; 

21 

22 while (in. hasNextLine()) 

23 { 

24 String line = in.nextLineQ() ; 

25 out.printin('/* “ + lineNumber + " */ " + line); 
26 lineNumber++; 

27 } 

28 

29 out.close(); 

30 } 

31 } 

SELF CHECK 


1. What happens when you supply the same name for the input and output files to 
the LineNumberer program? 


2. What happens when you supply the name of a nonexistent input file to the 
LineNumberer program? 


COMMON ERROR 11.1 
Backslashes in File Names 


When you specify a file name as a constant string, and the name contains backslash charac- 
ters (as ina Windows file name), you must supply each backslash twice: 


in = new FileReader('"c:\\homework\\input.dat") ; 


Recall that a single backslash inside quoted strings is an escape character that is combined 
with another character to form a special meaning, such as \n for a newline character. The \\ 
combination denotes a single backslash. 

When a user supplies a file name to a program, however, the user should not type the 
backslash twice. 
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File Dialog Boxes 


In a program with a graphical user interface, you will want to 
use a file dialog box (such as the one shown in the figure 
below) whenever the users of your program need to pick a 
file. The JFileChooser class implements a file dialog box for 
the Swing user interface toolkit. 
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A JFileChooser Dialog Box 


The JFileChooser class relies on another class, File, which 


A File object describes a describes disk files and directories. For example, 


file or ‘directory. 


File inputFile = new FileC"input.txt"); 


describes the file input.txt in the current directory. The File class has methods to delete or 
rename the file. The file does not actually have to exist—you may want to pass the File 
object to an output stream or writer so that the file can be created. The exists method 
returns true if the file already exists. 

You cannot directly use a File object for reading or writ- 
You can passa File - ing. You still need to construct a file reader or writer from the 
object to the constructor | File object. Simply pass the File object in the constructor. 


a file ise Mi or FileReader in = new FileReader(inputFile); 


The JFileChooser class has many options to fine-tune the 
display of the dialog box, but in its most basic form it is quite 
simple: Construct a file chooser object; then call the showOpenDialog or showSaveDialog 
method. Both methods show the same dialog box, but the button for selecting a file is labeled 
“Open” or “Save”, depending on which method you call. 

For better placement of the dialog box on the screen, you can specify the user interface 
component over which to pop up the dialog box. If you don’t care where the dialog box pops 
up, you can simply pass nu11. These methods return either JFileChooser.APPROVE_OPTION, if 
the user has chosen a file, or JFileChooser.CANCEL_OPTION, if the user canceled the selection. 
If a file was chosen, then you call the getSelectedFile method to obtain a File object that 
describes the file. Here is a complete example: 


JFileChooser chooser = new JFileChooser(); 

FileReader in = null; 

if Cchooser.showOpenDialog(null) == JFileChooser.APPROVE_OPTION) 
{ 


File selectedFile = chooser.getSelectedFile(); 
reader = new FileReader(selectedFi le); 
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ADVANCED TOPIC 11.2 


Command Line Arguments 


Depending on the operating system and Java development system used, there are different 
methods of starting a program—for example, by selecting “Run” in the compilation environ- 
ment, by clicking on an icon, or by typing the name of the program at a prompt in a terminal 
or shell window. The latter method is called “invoking the program from the command 
line”. When you use this method, you must type the name of the program, but you can also 
type in additional information that the program can use. These additional strings are called 
command line arguments. 

For example, it is convenient to specify the input and output file names for the Line- 
Numberer program on the command line: 


java LineNumberer input.txt numbered.txt 


The strings that are typed after the Java program name are 
placed into the args parameter of the main method. (Now 
you finally know the use of the args parameter that you have 
seen in sO many programs!) 

For example, with the given program invocation, the args 
parameter of the LineNumberer.main method has the follow- 
ing contents: 


‘When you launch a program 
from ne comr and line, you 


Bee ee e ey " 
main method. args[O] 1s "input.txt 


® args[1] is "output. txt" 


The main method can then process these parameters, for example: 


if (args. length >= 1) 
inputFileName = args[0]; 


It is entirely up to the program what to do with the command line argument strings. It 1s cus- 
tomary to interpret strings starting with a hyphen (-) as options and other strings as file 
names. For example, we may want to enhance the LineNumberer program so that a -c option 
places line numbers inside comment delimiters; for example 


java LineNumberer -c HelloWorld.java HelloWorld.txt 


If the -c option is missing, the delimiters should not be included. Here is how the main 
method can analyze the command line arguments: 


for (String a : args) 


{ 
if (a.startswith("-")) // It’s an option 
{ 
if (a.equals("-c")) useCommentDelimiters = true; 
} 
else if CinputFileName == null) inputFileName = a; 
else if CoutputFileName == null) outputFileName = a; 
} 


Should you support command line interfaces for your programs, or should you instead sup- 
ply a graphical user interface with file chooser dialog boxes? For a casual and infrequent user, 
the graphical user interface is much better. The user interface guides the user along and 
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makes it possible to navigate the application without much knowledge. But for a frequent 
user, graphical user interfaces have a major drawback—they are hard to automate. If you 
need to process hundreds of files every day, you could spend all your time typing file names 
into file chooser dialog boxes. But it is not difficult to call a program multiple times automat- 
ically with different command line arguments. Productivity Hint 7.1 discusses how to use 


shell scripts (also called batch files) for this purpose. 


To. gnal an exceptional _ 
condition, use the throw 
_ statement to throw an 

_ exception Onis 


There are two main aspects to exception handling: reporting and recovery. A major 
challenge of error handling is that the point of reporting is usually far apart from 
the point of recovery. For example, the get method of the ArrayList class may 
detect that a nonexistent element is being accessed, but it does not have enough 
information to decide what to do about this failure. Should the user be asked to try 
a different operation? Should the program be aborted after saving the user’s work? 
The logic for these decisions is contained in a different part of the program code. 

In Java, exception handling provides a flexible mechanism for passing control 

from the point of error reporting to a competent recovery handler. In the remainder 
of this chapter we will look into the details of this mechanism. 
When you detect an error condition, your job is really easy. You just 
throw an appropriate exception object, and you are done. For exam- 
ple, suppose someone tries to withdraw too much money from a 
bank account. 


public class BankAccount 


public void withdraw(double amount) 
if Camount > balance) 
// Now what? 
} 
} 


First look for an appropriate exception class. The Java library provides many classes 
to signal all sorts of exceptional conditions. Figure 1 shows the most useful ones. 

Look around for an exception type that might describe your situation. How 
about the I1llegalStateException? Is the bank account in an illegal state for the 
withdraw operation? Not really—some withdraw operations could succeed. Is the 
parameter value illegal? Indeed it is. It is just too large. Therefore, let’s throw an 
T1legalArgumentException. (The term argument is an alternative term for a parame- 
ter value.) 


CHAPTER 11 «& Input/Output and Exception Handling 


i 


Arithmetic. 


sities 
aan 
aie 


ava 
Sia 


sata ia 
Suenos 


Exception | 


Tl legalStat 


Exception. 


_ IndexOut 


— OfBounds 
Exception 


I\Pointer 


Figure 1 The Hierarchy of Exception Classes 
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public class BankAccount 


{ 
public void withdraw(Cdouble amount) 
{ 
if Camount > balance) 
{ 
Il legalArgumentException exception 
= new IllegalArgumentExceptionC"Amount exceeds balance"); 
throw exception; 
, 
balance = balance - amount; 
} 
} 


Actually, you don’t have to store the exception object in a variable. You can just 
throw the object that the new operator returns: 


throw new IllegalArgumentException("Amount exceeds balance"); 


Vihen yor theow an When you throw an exception, execution does not continue with 


exception, the current the next statement but with an exception handler. For now, we 
maathnd terminates won't worry about the handling of the exception. That is the topic 
immediately. | of Section 11.4. 


SYNTAX 11.1 Throwing an Exception 


throw exceptionObject; 


Example: 


throw new I]1legalArgumentException() ; 


Purpose: 


To throw an exception and transfer control to a handler for this exception type 


SELF CHECK 


3. How should you modify the deposit method to ensure that the balance is never 
negative? 


4. Suppose you construct a new bank account object with a zero balance and then 
call withdraw(10). What is the value of balance afterwards? 
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lal 


Java exceptions fall into two categories, called checked and 
unchecked exceptions. When you call a method that throws a 
checked exception, the compiler checks that you don’t ignore it. You 
must tell the compiler what you are going to do about the exception 
if it is ever thrown. For example, all subclasses of IOException are 
checked exceptions. On the other hand, the compiler does not 
require you to keep track of unchecked exceptions. Exceptions, such 
as NumberFormatException, I1legalArgumentException, and Nul1PointerException, are 
unchecked exceptions. More generally, all exceptions that belong to subclasses of 
RuntimeException are unchecked, and all other subclasses of the class Exception are 
checked. (In Figure 1, the checked exceptions are shaded in a darker color.) There 1s 
a second category of internal errors that are reported by throwing objects of type 
Error. One example is the OutOfMemoryError, which is thrown when all available 
memory has been used up. These are fatal errors that happen rarely and are beyond 
meus control. They too are unchecked. 

= Why have two kinds of exceptions? A checked exception 
describes a problem that is likely to occur at times, no matter how 
careful you are. The unchecked exceptions, on the other hand, are 
your fault. For example, an unexpected end of file can be caused by 
forces beyond your control, such as a disk error or a broken network 
connection. But you are to blame for a Nul1PointerException, 
because your code was wrong when it tried to use a nu11 reference. 

The compiler doesn’t check whether you handle a Nu11Pointer- 
Exception, because you should test your references for nu11 before using them 
rather than install a handler for that exception. The compiler does insist that your 
program be able to handle error conditions that you cannot prevent. 

Actually, those categories aren’t perfect. For example, the Scanner.nextInt 
method throws an unchecked InputMismatchException if a user enters an input that 
is not an integer. A checked exception would have been more appropriate because 
the programmer cannot prevent users from entering incorrect input. (The designers 
of the Scanner class made this choice to make the class easy to use for beginning 
programmers.) 

As you can see from Figure 1, the majority of checked exceptions occur when 
you deal with input and output. That is a fertile ground for external failures beyond 
your control—a file might have been corrupted or removed, a network connection 
might be overloaded, a server might have crashed, and so on. Therefore, you will 
need to deal with checked exceptions principally when programming with files and 
streams. 

You have seen how to use the Scanner class to read data from a file, by passing a 
FileReader object to the Scanner constructor: 


are two kinds of 


String filename =... .; 
FileReader reader = new FileReader(filename) ; 
Scanner in = new Scanner(reader) ; 
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However, the FileReader constructor can throw a FileNotFoundException. The 
Fi leNotFoundException is a checked exception, so you need to tell the compiler what 
you are going to do about it. You have two choices. You can handle the exception, 
using the techniques that you will see in Section 11.4. Or you can simply tell the 
compiler that you are aware of this exception and that you want your method to be 
terminated when it occurs. The method that reads input rarely knows what to do 
about an unexpected error, so that is usually the better option. 

To declare that a method should be terminated when a checked exception occurs 
within it, tag the method with a throws specifier. 


public class DataSet 


public void read(String filename) throws FileNotFoundException 
FileReader reader = new FileReader (fi lename) ; 
Scanner in = new Scanner(Creader) ; 
} 
} 


The throws clause in turn signals the caller of your method that it 
may encounter a FileNotFoundException. Then the caller needs to 
make the same decision—handle the exception, or tell its caller that 
the exception may be thrown. 

If your method can throw checked exceptions of different types, you separate 
the exception class names by commas: 


public void read(String filename) 
throws IOException, ClassNotFoundException 


Always keep in mind that exception classes form an inheritance hierarchy. For 
example, FileNotFoundException is a subclass of IOException. Thus, if a method can 
throw both an IOException and a FileNotFoundException, you only tag it as throws 
IOException. 

It sounds somehow irresponsible not to handle an exception when you know 
that it happened. Actually, though, it is usually best not to catch an exception if you 
don’t know how to remedy the situation. After all, what can you do in a low-level 
read method? Can you tell the user? How? By sending a message to System.out? 
You don’t know whether this method is called in a graphical program or an embed- 
ded system (such as a vending machine), where the user may never see System. out. 
And even if your users can see your error message, how do you know that they can 
understand English? Your class may be used to build an application for users in 
another country. If you can’t tell the user, can you patch up the data and keep 
eoing? How? If you set a variable to zero, nu11 or an empty string, that may just 
cause the program to break later, with much greater mystery. 

Of course, some methods in the program know how to communicate with the 
user or take other remedial action. By allowing the exception to reach those meth- 
ods, you make it possible for the exception to be processed by a competent handler. 
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SYNTAX 11.2 Exception Specification 


accessSpecifier returnType methodName (parameterType parameterName, . . .) 
throws ExceptionClass, ExceptionClass, 


Example: 


public void read(FileReader in) 
throws IOException 


Purpose: 


To indicate the checked exceptions that this method can throw 


SELF CHECK 


5. Suppose a method calls the FileReader constructor and the read method of the 
FileReader class, which can throw an I0Exception. Which throws specification 
should you use? 


6. Why is a Nul1PointerException not a checked exception? 


Every exception should be handled somewhere in your program. If 
an exception has no handler, an error message is printed, and your 
program terminates. That may be fine for a student program. But 
ie cause you would not want a professionally written program to die just 
because some method detected an unexpected error. Therefore, you 
the h should install exception handlers for all exceptions that your pro- 
nee a ‘catch clause. 1 gram might throw. 
| | You install an exception handler with the try/catch statement. 
Each try block contains one or more statements that may cause an exception. Each 
catch clause contains the handler for an exception type. Here is an example: 


cry 
{ 
String filename = . as 
FileReader reader = new FileReader(filename) ; 
Scanner in = new Scanner(reader) ; 
String input = in.nextQ); 
int value = Integer.parseInt(Cinput) ; 


} 


catch (IOException exception) 


{ 


exception.printStackTrace() ; 
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catch (NumberFormatException exception) 


{ 
} 


Three exceptions may be thrown in this try block: The FileReader constructor can 
throw a FileNotFoundException, Scanner.next can throw a NoSuchElementException, 
and Integer.parseInt can throw a NumberFormatException. 


System.out.printInC"Input was not a number"); 


SYNTAX 11.3 General try Block 


try 
{ 
statement 
statement 
} 
catch (ExceptionClass exceptionObject) 
{ 
statement 
statement 
} 
catch (ExceptionClass exceptionObject) 
{ 
statement 
statement 
} 
Example: 
try 
{ 


System.out.printInC"How old are you?"); 
int age = in.nextInt(); 


System.out.printInC"Next year, you’1l be " + (Cage + 1)); 
} 
catch (InputMismatchException exception) 
{ 
exception.printStackTrace() ; 
} 
Purpose: 


To execute one or more statements that may generate exceptions. If an exception occurs 
and it matches one of the catch clauses, execute the first one that matches. If no excep- 
tion occurs, or an exception is thrown that doesn’t match any catch clause, then skip the 
catch clauses. 
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If any of these exceptions is actually thrown, then the rest of the instructions in 
the try block are skipped. Here is what happens for the various exception types: 


e Ifa FileNotFoundException is thrown, then the catch clause for the IOException is 
executed. (Recall that FileNotFoundException is a subclass of IOException.) 


e IfaNumberFormatException occurs, then the second catch clause is executed. 


e A NoSuchElementException is not caught by any of the catch clauses. The excep- 
tion remains thrown until it is caught by another try block. 


When the catch (IOException exception) block is executed, then some method in 
the try block has failed with an IOException. The variable exception contains a ref- 
erence to the exception object that was thrown. The catch clause can analyze that 
object to find out more details about the failure. For example, you can get a print- 
out of the chain of method calls that lead to the exception, by calling 


exception.printStackTrace() 


In these sample catch clauses, we merely inform the user of the source of the prob- 
lem. A better way of dealing with the exception would be to give the user another 
chance to provide a correct input—see Section 11.7 for a solution. 

It is important to remember that you should place catch clauses only in methods 
in which you can competently handle the particular exception type. 


SELF CHECK 


7. Suppose the file with the given file name exists and has no contents. Trace the 
flow of execution in the try block in this section. 


8. Is there a difference between catching checked and unchecked exceptions? 


QUALITY TIP 11.1 
Throw Early, Catch Late 


When a method notices a problem that it cannot solve, it is 
generally better to throw an exception rather than try to 
come up with an imperfect fix (such as doing nothing or 
returning a default value). 

Conversely, a method should only catch an exception if it 
can really remedy the situation. Otherwise, the best remedy 
is simply to have the exception propagate to its caller, allowing it to be caught by a compe- 
tent handler. 

These principles can be summarized with the slogan “throw early, catch late”. 


It is better to declare that a 
method throws a checked | 
exception than to handle 

the exception poorly. 
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QUALITY Tip 11.2 


Do Not Squelch Exceptions 


When you call a method that throws a checked exception and you haven’t specified a han- 
dler, the compiler complains. In your eagerness to continue your work, it is an understand- 
able impulse to shut the compiler up by squelching the exception: 


try 
{ 


FileReader reader = new FileReader(filename) ; 
// Compiler complained about FileNotFoundException 


} 

catch (Exception e) {} // So there! 
The do-nothing exception handler fools the compiler into thinking that the exception has 
been handled. In the long run, this is clearly a bad idea. Exceptions were designed to transmit 
problem reports to a competent handler. Installing an incompetent handler simply hides an 
error condition that could be serious. 


Occasionally, you need to take some action whether or not an exception is thrown. 
The finally construct is used to handle this situation. Here is a typical situation. 

It is important to close a PrintWriter to ensure that all output is written to the 
file. In the following code segment, we open a writer, call one or more methods, and 
then close the writer: 


PrintWriter out = new PrintWriter(filename) ; 
writeData(out) ; 
out.close(); // May never get here 


Now suppose that one of the methods before the last line throws an exception. 
Then the call to close is never executed! Solve this problem by placing the call to 
close inside a finally clause: 


PrintWriter out = new PrintWriter(fi lename) ; 
try 
{ 


} 
finally 
{ 


} 


writeData(out) ; 


out.close(); 
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In a normal case, there will be no problem. When the try block is 
completed, the finally clause is executed, and the writer is closed. 
: However, if an exception occurs, the finally clause is also executed 
NE to be before the exception is passed to its handler. 
executed, whethe } Use the finally clause whenever you need to do some clean up, 
: an exception i is thrown. such as closing a file, to ensure that the clean up happens no matter 
: " ~ how the method exits. 
It is also possible to have a finally clause following one or more catch clauses. 
Then the code in the finally clause is executed whenever the try block is exited in 
any of three ways: 


‘Once a try block i Is 8 


1. After completing the last statement of the try block 


2. After completing the last statement of a catch clause, if this try block caught 
an exception 


3. When an exception was thrown in the try block and not caught 


SYNTAX 11.4 finally Clause 


try 
{ 


statement 
statement 


} 
finally 


{ 
statement 
statement 


} 


Example: 


PrintWriter out = new PrintWriter(filename) ; 
try 
{ 


writeData(out) ; 


i 
finally 


{ 


out.close(); 


} 


Purpose: 


To ensure that the statements in the finally clause are executed whether or not the 
statements in the try block throw an exception 
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However, we recommend that you don’t mix catch and finally clauses in the same 


try block—see Quality Tip 11.3. 


SELF CHECK 


9. Why was the out variable declared outside the try block? 


10. Suppose the file with the given name does not exist. Trace the flow of execution 
of the code segment in this section. 


QUALITY TIP 11.3 
Do Not Use catch and final ly in the Same try Statement 


It is tempting to combine catch and finally clauses, but the resulting code can be hard to 
understand. Instead, you should use a try/finally statement to close resources and a sepa- 
rate try/catch statement to handle errors. For example, 


try 
{ 
PrintWriter out = new PrintWriter(filename) ; 
try 
{ 
// Write output 
} 
finally 
{ 
out.close(); 
} 


catch (IOException exception) 


// Handle exception 
} 
Note that the nested statements work correctly if the call out.close() throws an excep- 
tion—see Exercise R11.18. 


Sometimes none of the standard exception types describe your particular error con- 
dition well enough. In that case, you can design your own exception class. Consider 
a bank account. Let’s report an InsufficientFundsException when an attempt 1s 
made to withdraw an amount from a bank account that exceeds the current balance. 


if Camount > balance) 


{ 
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throw new InsufficientFundsException( 
“withdrawal of " + amount + " exceeds balance of " + balance); 


Now you need to define the InsufficientFundsException class. 
Should it be a checked or an unchecked exception? Is it the fault of 
some external event, or is it the fault of the programmer? We take the 
position that the programmer could have prevented the exceptional 
condition —after all, it would have been an easy matter to check whether 
amount <= account.getBalance() before calling the withdraw method. Therefore, the 
exception should be an unchecked exception and extend the RuntimeException class 
or one of its subclasses. 

It is customary to provide two constructors for an exception class: a default con- 
structor and a constructor that accepts a message string describing the reason for 
the exception. Here is the definition of the exception class. 


public class InsufficientFundsException 
extends RuntimeException 


if 
public InsufficientFundsException() {} 
public InsufficientFundsException(String message) 
{ 
Super (message) ; 
} 
5 


When the exception is caught, its message string can be retrieved using the getMessage 
method of the RunTi meException class. 


SELF CHECK 


11. What is the purpose of the call super(message) in the second Insufficient- 
FundsException constructor? 


12. Suppose you read bank account data from a file. Contrary to your expectation, 
the next input value is not of type double. You decide to implement a BadData- 
Exception. Which exception class should you extend? 


QUALITY TIP 11.4 


Do Throw Specific Exceptions 


When throwing an exception, you should choose an exception class that describes the situa- 
tion as closely as possible. For example, it would be a bad idea to simply throw a Runtime- 
Exception object when a bank account has insufficient funds. This would make it far too 
difficult to catch the exception. After all, if you caught all exceptions of type Runtime- 
Exception, your catch clause would also be activated by exceptions of the type Nul1Pointer- 
Exception, ArrayIndexOutOfBoundsException, and so on. You would then need to carefully 
examine the exception object and attempt to deduce whether the exception was caused by 
insufficient funds. 
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If the standard library does not have an exception class that describes your particular 
error situation, simply define a new exception class. 


This section walks through a complete example of a program with exception han- 
dling. The program asks a user for the name of a file. The file is expected to contain 
data values. The first line of the file contains the total number of values, and the 
remaining lines contain the data. A typical input file looks like this: 


What can go wrong? There are two principal risks. 


e The file might not exist. 
e The file might have data in the wrong format. 


Who can detect these faults? The FileReader constructor will throw an exception 
when the file does not exist. The methods that process the input values need to 
throw an exception when they find an error in the data format. 

What exceptions can be thrown? The FileReader constructor throws a FileNot- 
FoundException when the file does not exist, which is very appropriate in our situa- 
tion. The close method of the FileReader class can throw an I0Exception. Finally, 
when the file data is in the wrong format, we will throw a BadDataException, a cus- 
tom checked exception class. We use a checked exception because corruption of a 
data file is beyond the control of the programmer. 

Who can remedy the faults that the exceptions report? Only the main method of 
the DataAnalyzer program interacts with the user. It catches the exceptions, prints 
appropriate error messages, and gives the user another chance to enter a correct file. 


ch11/data/DataAnalyzer.java 


import java.io.FileNotFoundException; 
import java.io. IOException; 
import java.util.Scanner; 


/* ¥ 
This program reads a file containing numbers and analyzes its contents. 
If the file doesn’t exist or contains strings that are not numbers, an 


1 

2 

3 

4 

5 

6 

7 

8 error message is displayed. 

9 * 
10 public class DataAnalyzer 
11 
12 


{ 
public static void main(String[] args) 
13 { 
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14 Scanner in = new Scanner(System.in); 

15 DataSetReader reader = new DataSetReader(); 
16 

17 boolean done = false; 

18 while (!done) 

19 { 

20 try 

21 { 

Pe A System.out.printInC''Please enter the file name: "); 
23 String filename = in.next(); 

24 

25 double[] data = reader.readFile(filename) ; 
26 double sum = 0; 

27 for (double d : data) sum = sum + d: 

28 System.out.printInC'The sum is " + sum); 
29 done = true; 

30 

31 catch (FileNotFoundException exception) 

32 { 

33 System.out.printInC"File not found."); 
34 } 

35 catch (BadDataException exception) 

36 { 

37 System.out.printIn('Bad data: " + exception.getMessage()); 
38 } 

39 catch (IOException exception) 

40 { 

41 exception.printStackTrace() ; 

42 } 

43 i 

44 

45 } 


The first two catch clauses in the main method give a human-readable error 
report if the file was not found or bad data was encountered. However, if another 
IOException occurs, then we print the stack trace so that a programmer can diagnose 
the problem. 

The following readFile method of the DataSetReader class constructs the Scanner 
object and calls the readData method. It is completely unconcerned with any excep- 
tions. If there is a problem with the input file, it simply passes the exception to its 
caller. 


public double[] readFile(String filename) 
throws IOException, BadDataException 


FileReader reader = new FileReader(filename) ; 

cry 

{ 
Scanner in = new Scanner(reader) ; 
readData(in); 

} 

finally 

{ 
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reader.close(); 


} 


return data; 


} 


Note how the finally clause ensures that the file is closed even when an exception 
occurs. 

Also note that the throws specifier of the readFile method need not include the 
Fi leNotFoundException class because it is a subclass of IOException. 

Next, here is the readData method of the DataSetReader class. It reads the number 
of values, constructs an array, and calls readValue for each data value. 


private void readData(Scanner in) throws BadDataException 


{ 
if Clin. hasNextIntQ) 
throw new BadDataException("Length expected") ; 
int numberOfValues = in.nextIntQ; 
data = new double[numberOfValues] ; 


for Cint i = 0; i < numberOfValues; 1++) 
readValue(in, 1); 


if Cin.hasNext(Q) 
throw new BadDataException("End of file expected") ; 


} 

This method checks for two potential errors. The file might not start with an inte- 
ger, or it might have additional data after reading all values. 

However, this method makes no attempt to catch any exceptions. Plus, if the 
readValue method throws an exception—which it will if there aren’t enough values 
in the file—the exception is simply passed on to the caller. 

Here is the readValue method: 


private void readValue(Scanner in, int 1) throws BadDataException 


{ 
if C!in.hasNextDouble()) 
throw new BadDataException("Data value expected") ; 
data[i] = in.nextDoubleQ() ; 
} 


To see the exception handling at work, look at a specific error scenario. 


1. DataAnalyzer.main calls DataSetReader. readFile. 

2. readFile calls readData. 

3. readData calls readValue. 

4. readValue doesn’t find the expected value and throws a BadDataException. 
5. readValue has no handler for the exception and terminates immediately. 
6. readData has no handler for the exception and terminates immediately. 


7. readFile has no handler for the exception and terminates immediately after 
executing the finally clause and closing the file. 


8. DataAnalyzer.main has a handler for a BadDataException. That handler prints a 
message to the user. Afterwards, the user is given another chance to enter a file 
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This example shows the separation between error detection (in the DataSetReader. 
readValue method) and error handling (in the DataAnalyzer.main method). In 
between the two are the readData and readFile methods, which just pass exceptions 


name. Note that the statements computing the sum of the values have been 
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skipped. 


along. 


ch11 /data/DataSetReader.java 


Import java.io.FileReader; 
import java.io. IOException; 
import java.util.Scanner; 


/* * 


Reads a data set from a file. The file must have the format 
numberOfValues 

valuel 

value2 


public class DataSetReader 


{ 


{ 


* / 


private void readData(Scanner in) throws BadDataException 


{ 


ale 
na 


Reads a data set. 


@param filename the name of the file holding the data 
@return the data in the file 


ublic double[] readFile(String filename) 


throws IOException, BadDataException 


FileReader reader = new FileReader(filename) ; 

try 

{ 
Scanner in = new Scanner(reader) ; 
readData(in); 

; 

finally 

t 


} 


return data; 


reader.close(); 


Reads all data. 


@param in the scanner that scans the data 


if Clin. hasNextIntQ) 


throw new BadDataException("Length expected"); 


int numberOfValues = in.nextInt(); 
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ad data = new double[numberOfValues] ; 

45 

46 for Cint i = 0; 71 < numberOfValues; i++) 

47 readValue(in, 1); 

48 

49 if Cin. hasNext()) 

50 throw new BadDataException("End of file expected"); 
51 } 

52 

53 dei 

54 Reads one data value. 

55 @param in the scanner that scans the data 

56 @param i the position of the value to read 

57 * / 

58 private void readValue(Scanner in, int i) throws BadDataException 
59 { 

60 if (!in.hasNextDouble(Q)) 

61 throw new BadDataException("Data value expected"); 
62 data[i] = in.nextDoubleQ; 

63 } 

64 

65 private double[] data; 

66 } 


ch11/data/BadDataException.java 


l wv 
Z This class reports bad input data. 
3 */ 
4 public class BadDataException extends Exception 
5 { 
6 public BadDataException() {} 
7 public BadDataException(String message) 
8 { 
9 super(message) ; 
10 } 
ll } 
SELF CHECK 


13. Why doesn’t the DataSetReader. readFile method catch any exceptions? 


14. Suppose the user specifies a file that exists and is empty. Trace the flow of 
execution. 
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The Ariane Rocket Incident 


The European Space Agency (ESA), Europe’s counterpart to NASA, had developed a rocket 
model called Ariane that it had successfully used several times to launch satellites and scien- 
tific experiments into space. However, when a new version, the Ariane 5, was launched on 
June 4, 1996, from ESA’s launch site in Kourou, French Guiana, the rocket veered off course 
about 40 seconds after liftoff. Flying at an angle of more than 20 degrees, rather than straight 
up, exerted such an aerodynamic force that the boosters separated, which triggered the auto- 
matic self-destruction mechanism. The rocket blew itself up. 

The ultimate cause of this accident was an unhandled exception! The rocket contained 
two identical devices (called inertial reference systems) that processed flight data from mea- 
suring devices and turned the data into information about the rocket position. The onboard 
computer used the position information for controlling the boosters. The same inertial refer- 
ence systems and computer software had worked fine on the Ariane 4. 

However, due to design changes to the rocket, one of the sensors measured a larger accel- 
eration force than had been encountered in the Ariane 4. That value, expressed as a floating- 
point value, was stored in a 16-bit integer (like a short variable in Java). Unlike Java, the Ada 
language, used for the device software, generates an exception if a floating-point number is 
too large to be converted to an integer. Unfortunately, the programmers of the device had 
decided that this situation would never happen and didn’t provide an exception handler, 

When the overflow did happen, the exception was triggered and, because there was no 
handler, the device shut itself off. The onboard computer sensed the failure and switched 
over to the backup device. However, that device had shut itself off for exactly the same rea- 
son, something that the designers of the rocket had not expected. They figured that the 
devices might fail for mechanical reasons, and the chances of two devices having the same 
mechanical failure was considered remote. At that point, the rocket was without reliable 
position information and went off course. 

Perhaps it would have been better if the software hadn’t been so thorough? If it had 
ignored the overflow, the device wouldn’t have been shut off. It would have computed bad 
data. But then the device would have reported wrong position data, which could have been 
just as fatal. Instead, a correct implementation should have caught overflow exceptions and 
come up with some strategy to recompute the flight data. Clearly, giving up was not a rea- 
sonable option in this context. 


The Explosion of the Ariane Rocket 
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The advantage of the exception-handling mechanism is that it makes these issues explicit 


to programmers—something to think about when you curse the Java compiler for complain- 
ing about uncaught exceptions. 
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16. 


When reading text files, use the Scanner class. 
When writing text files, use the PrintWriter class and the print/printin methods. 
You must close all files when you are done processing them. 


The JFileChooser dialog box allows users to select a file by navigating through 
directories. 


A File object describes a file or directory. 
You can pass a File object to the constructor of a file reader, writer, or stream. 


When you launch a program from the command line, you can specify argu- 
ments after the program name. The program can access these strings by 
processing the args parameter of the main method. 


To signal an exceptional condition, use the throw statement to throw an 
exception object. 


When you throw an exception, the current method terminates immediately. 


There are two kinds of exceptions: checked and unchecked. Unchecked 
exceptions extend the class Runt imeException or Error. 


Checked exceptions are due to external circumstances that the programmer 
cannot prevent. The compiler checks that your program handles these 
exceptions. 


Add a throws specifier to a method that can throw a checked exception. 


In a method that is ready to handle a particular exception type, place the state- 
ments that can cause the exception inside a try block, and the handler inside a 
catch clause. 


It is better to declare that a method throws a checked exception than to handle 
the exception poorly. 


Once atry block is entered, the statements in a finally clause are guaranteed to 
be executed, whether or not an exception is thrown. 


You can design your own exception types—subclasses of Exception or Runtime- 
Exception. 
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CLASSES, OBJECTS, AND METHODS 


java.io.EOFException java. lang.NumberFormatException 
java.io.File java. lang.RuntimeException 
exists java. lang.Throwable 
java.io.Fi leNotFoundException getMessage 
java.io.FileReader printStackTrace 
java.io. IOException java.util.InputMismatchException 
jJava.io.PrintWriter java.util .NoSuchElementException 
close java.util.Scanner 
print close 
printin jJavax.swing.JFileChooser 
java. lang.Error getSelectedFile 
java. lang.I]legalArgumentException showOpenDialog 
java. lang.I]legalStateException sShowSaveDialog 


java. lang.Nul1PointerException 


REVIEW EXERCISES 


Exercise R11.1. What happens if you try to open a file for reading that doesn’t exist? 
What happens if you try to open a file for writing that doesn’t exist? 


Exercise R11.2. What happens if you try to open a file for writing, but the file or 
device is write-protected (sometimes called read-only)? Try it out with a short test 
program. 


Exercise R11.3. How do you open a file whose name contains a backslash, like 
c:\temp\output.dat? 


Exercise R11.4. What is a command line? How can a program read its command line 
arguments? 


Exercise R11.5. Give two examples of programs on your computer that read argu- 
ments from the command line. 


Exercise R11.6. If a program Woozle is started with the command 
java Woozle -Dname=piglet -I\eeyore -v heff.txt a.txt lump.txt 


what are the values of args[0], args[1], and so on? 


Exercise R11.7, What is the difference between throwing an exception and catching 
an exception? 


Exercise R11.8. What 1s a checked exception? What is an unchecked exception? Is a 
Nu11PointerException checked or unchecked? Which exceptions do you need to 
declare with the throws keyword? 


Exercise R11.9. Why don’t you need to declare that your method might throw a 
Nul1PointerException? 
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Exercise R11.10. When your program executes a throw statement, which statement is 
executed next? 


Exercise R11.11. What happens if an exception does not have a matching catch 
clause? 


Exercise R11.12. What can your program do with the exception object that a catch 
clause receives? 


Exercise R11.13. Is the type of the exception object always the same as the type 
declared in the catch clause that catches it? 


Exercise R11.14. What kind of values can you throw? Can you throw a string? An 
integer? 


Exercise R11.15. What is the purpose of the finally clause? Give an example of how 
it can be used. 


Exercise R11.16. What happens when an exception is thrown, the code of a finally 
clause executes, and that code throws an exception of a different kind than the orig- 
inal one? Which one is caught by a surrounding catch clause? Write a sample pro- 
gram to try it out. 


Exercise R11.17. Which exceptions can the next and nextInt methods of the Scanner 
class throw? Are they checked exceptions or unchecked exceptions? 


Exercise R11.18. Suppose the catch clause in the example of Quality Tip 11.3 had 
been moved to the inner try block, eliminating the outer try block. Does the 
modified code work correctly if (a) the FileReader constructor throws an exception 
and (b) the close method throws an exception? 


Exercise R11.19. Suppose the program in Section 11.7 reads a file containing the fol- 
lowing values: 

0 

1 


2 
3 


What is the outcome? How could the program be improved to give a more accurate 
error report? 


Exercise R11.20. Can the readFile method in Section 11.7 throw a Nu11Pointer- 
Exception? If so, how? 


Additional review exercises are available in WileyPLUS. 


PROGRAMMING EXERCISES 


Exercise P11.1. Write a program that asks a user for a file name and prints the 
number of characters, words, and lines in that file. 
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we Exercise P11.2. Write a program that asks the user for a file name and counts the 
number of characters, words, and lines in that file. Then the program asks for the 
name of the next file. When the user enters a file that doesn’t exist, the program 
prints the total counts of characters, words, and lines in all processed files and exits. 


*&* Exercise P11.3. Write a program CopyFile that copies one file to another. The file 
names are specified on the command line. For example, 


java CopyFile report.txt report.sav 


** Exercise P11.4. Write a program that concatenates the contents of several files into 
one file. For example, 


java CatFiles chapterl.txt chapter2.txt chapter3.txt book.txt 


makes a long file, book. txt, that contains the contents of the files chapter1.txt, 
chapter2.txt, and chapter3.txt. The output file is always the last file specified on 
the command line. 


*&* Exercise P11.5. Write a program Find that searches all files specified on the command 
line and prints out all lines containing a keyword. For example, if you call 


java Find ring report.txt address.txt Homework. java 
then the program might print 


report.txt: has broken up an international ring of DVD bootleggers that 
address.txt: Kris Kringle, North Pole 

address.txt: Homer Simpson, Springfield 

Homework.java: String filename; 


The keyword is always the first command line argument. 


*&*& Exercise P11.6. Write a program that checks the spelling of all words in a file. It 
should read each word of a file and check whether it is contained in a word list. A 
word list is available on most UNIX systems in the file /usr/dict/words. (If you 
don’t have access to a UNIX system, your instructor should be able to get you a 
copy.) The program should print out all words that it cannot find in the word list. 


we Exercise P11.7. Write a program that replaces each line of a file with its reverse. For 
example, if you run 


java Reverse HelloPrinter.java 
then the contents of HelloPrinter. java are changed to 


retnirPolleH ssalc cilbup 


{ 


Ysgra ][gnirtS(niam diov citats cilbup 


{ 


wodniw elosnoc eht ni gniteerg a yalpsiD // 


s)"!dlrow ,olleH"(nltnirp.tuo.metsyS 
; 
} 


Of course, if you run Reverse twice on the same file, you get back the original file. 
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Exercise P11.8. Write a program that replaces all tab characters '\t' in a file with the 
appropriate number of spaces. By default, the distance between tab columns should 
be 3 (the value we use in this book for Java programs) but it can be changed by the 
user. Expand tabs to the number of spaces necessary to move to the next tab col- 
umn. That may be /ess than three spaces. For example, consider the line containing 
"\t}\t| |\t|". The first tab is changed to three spaces, the second to two spaces, and 
the third to one space. Your program should be executed as 


java TabExpander filename 


or 
java -t tabwidth filename 


Exercise P11.9. Modity the BankAccount class to throw an I1legalArgumentException 
when the account is constructed with a negative balance, when a negative amount 1s 
deposited, or when an amount that is not between 0 and the current balance is with- 
drawn. Write a test program that causes all three exceptions to occur and that 
catches them all. 


Exercise P11.10. Repeat Exercise P11.9, but throw exceptions of three exception 
types that you define. 


Exercise P11.11. Write a program that asks the user to input a set of floating-point 
values. When the user enters a value that is not a number, give the user a second 
chance to enter the value. After two chances, quit reading input. Add all correctly 
specified values and print the sum when the user is done entering data. Use excep- 
tion handling to detect improper inputs. 


Exercise P11.12. Repeat Exercise P11.11, but give the user as many chances as neces- 
sary to enter a correct value. Quit the program only when the user enters a blank 
input. 


Exercise P11.13. Modify the DataSetReader class so that you do not call hasNextInt or 
hasNextDoub le. Simply have nextInt and nextDouble throw an InputMismatchException 
or NoSuchElementException and catch it in the main method. 


Exercise P11.14. Write a program that reads in a set of coin descriptions from a file. 
The input file has the format 


coinNamel coinValuel 
coinName2 coinValue2 


Add a method 
void read(Scanner in) throws IOException 


to the Coin class. Throw an exception if the current line is not properly formatted. 
Then implement a method 


static ArrayList<Coin> readFile(String filename) throws IOException 


In the main method, call readFile. If an exception is thrown, give the user a chance 
to select another file. If you read all coins successfully, print the total value. 
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Exercise P11.15. Design a class Bank that contains a number of bank accounts. Each 
account has an account number and a current balance. Add an accountNumber field 
to the BankAccount class. Store the bank accounts in an array list. Write a readFile 
method of the Bank class for reading a file with the format 


accountNumberl balancel 
accountNumber2 balance2 


Implement read methods for the Bank and BankAccount classes. Write a sample pro- 
gram to read in a file with bank accounts, then print the account with the highest bal- 


ance. If the file is not properly formatted, give the user a chance to select another file. 


Additional programming exercises are available in WileyPLUS. 


_ PROGRAMMING PROJECTS 


Project 11.1. You can read the contents of a web page with this sequence of commands. 


String address = "http://java.sun.com/index.htm1"; 
URL u = new URL(Caddress); 

URLConnection connection = u.openConnection(); 
InputStream stream = connection.getInputStream() ; 
Scanner in = new Scanner(stream) ; 


Some of these methods may throw exceptions —check out the API documentation. 
Design a class LinkFinder that finds all hyperlinks of the form 


<a href="link">link text</a> 


Throw an exception if you find a malformed hyperlink. Extra credit if your pro- 
gram can follow the links that it finds and find links in those web pages as well. 
(This is the method that search engines such as Google use to find web sites.) 
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When the Printwriter object is created, the output file is emptied. Sadly, that is 
the same file as the input file. The input file is now empty and the while loop 
exits immediately. 


The program throws and catches a FileNotFoundException, prints an error mes- 
sage, and terminates. 


. Throw an exception if the amount being deposited is less than zero. 


. The balance is still zero because the last statement of the withdraw method was 


never executed. 


. The specification throws IOException is sufficient because FileNotFound- 


Exception is a subclass of IOException. 


Because programmers should simply check for nu11 pointers instead of trying 
to handle a Nu11PointerException. 


The FileReader constructor succeeds, and in is constructed. Then the call 
in.next() throws a NoSuchElementException, and the try block is aborted. None 
of the catch clauses match, so none are executed. If none of the enclosing 
method calls catch the exception, the program terminates. 


No—you catch both exception types in the same way, as you can see from the 
code example on page 508. Recall that IOException is a checked exception and 
NumberFormatException is an unchecked exception. 


If it had been declared inside the try block, its scope would only have extended 
to the end of the try block, and the finally clause could not have closed it. 


The FileReader constructor throws an exception. The finally clause is exe- 
cuted. Since reader is nu11, the call to close is not executed. Next, a catch clause 
that matches the FileNotFoundException is located. If none exists, the program 
terminates. 


To pass the exception message string to the RuntimeException superclass. 


Exception or 10Exception are both good choices. Because file corruption is 
beyond the control of the programmer, this should be a checked exception, so 
it would be wrong to extend RuntimeException. 


It would not be able to do much with them. The DataSetReader class 1s a 
reusable class that may be used for systems with different languages and 
different user interfaces. Thus, it cannot engage in a dialog with the program 
user. 


DataAnalyzer.main calls DataSetReader.readFi le, which calls readData. The 
call in. hasNextInt(Q returns false, and readData throws a BadDataException. 
The readFile method doesn’t catch it, so it propagates back to main, where it 
is caught. 
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® To learn about the software life cycle 


® To learn how to discover new classes and methods 

® To understand the use of CRC cards for class discovery | 
© To be able to identify inheritance, aggregation, and 
dependency relationships between classes 


® To master the use of UML class diagrams to describe 
class relationships 


® To learn how to use object-oriented design to build 
complex programs 


To implement a software system successfully, be it as simple as your next 
homework project or as complex as the next air traffic monitoring system, some 
amount of planning, design, and testing is required. In fact, for larger projects, the 
amount of time spent on planning is much higher than the amount of time spent on 
programming and testing. 

If you find that most of your homework time is spent in front of the computer, 
keying in code and fixing bugs, you are probably spending more time on your 
homework than you should. You could cut down your total time by spending more 
on the planning and design phase. This chapter tells you how to approach these 


tasks in a systematic manner, using the object-oriented design methodology. 
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In this section we will discuss the software life cycle: the activities 
that take place between the time a software program is first con- 
ceived and the time it is finally retired. 

A software project usually starts because a customer has a prob- 
lem and 1s willing to pay money to have it solved. The Department of 
Defense, the customer of many programming projects, was an early 
proponent of a formal process tor software development. A formal 
process identifies and describes different phases and gives guide- 
lines for carrying out the phases and when to move from one phase 
to the next. 

Many software engineers break the development process down 
into the following five phases: 


e Analysis 


e Design 

e Implementation 
e Testing 

¢ Deployment 


In the analysis phase, you decide what the project is supposed to accomplish; you 
do not think about how the program will accomplish its tasks. The output of the 
analysis phase is a requirements document, which describes in complete detail what 
the program will be able to do once it is completed. Part of this requirements docu- 
ment can be a user manual that tells how the user will operate the program to derive 
the promised benefits. Another part sets performance criteria—how many inputs 
the program must be able to handle in what time, or what its maximum memory 
and disk storage requirements are. 
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In the design phase, you develop a plan for how you will implement the system. 
You discover the structures that underlie the problem to be solved. When you use 
object-oriented design, you decide what classes you need and what their most 
important methods are. The output of this phase is a description of the classes and 
methods, with diagrams that show the relationships among the classes. 

In the zmplementation phase, you write and compile program code to implement 
the classes and methods that were discovered in the design phase. The output of this 
phase is the completed program. 

In the testing phase, you run tests to verify that the program works correctly. 
The output of this phase is a report describing the tests that you carried out and 
their results. 

In the deployment phase, the users of the program install it and use it for its 
intended purpose. 

When formal development processes were first established in the 
early 1970s, software engineers had a very simple visual model of 
these phases. They postulated that one phase would run to comple- 
tion, its output would spill over to the next phase, and the next phase 
would begin. This model is called the waterfall model of software 
development (see Figure 1). 

In an ideal world the waterfall model has a lot of appeal: You fig- 
ure out what to do; then you figure out how to do it; then you do it; 
then you verify that you did it right; then you hand the product to the customer. 
When rigidly applied, though, the waterfall model simply did not work. It was very 


difficult to come up with a perfect requirement specification. It was quite common 


: arhe waterfall ‘model of 
software development _ 
describes a sequential 
process of analysis, _ 
design, implementation, 
: testing, and po ioyment, 


Analysis 
) 
Design 
| 
Implementation 
| 
Testing 
+) 


Deployment 


Figure 1 The Waterfall Model 
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to discover in the design phase that the requirements were inconsistent or that a 
small change in the requirements would lead to a system that was both easier to 
design and more useful for the customer, but the analysis phase was over, so the 
designers had no choice—they had to take the existing requirements, errors and all. 
This problem would repeat itself during implementation. The designers may have 
thought they knew how to solve the problem as efficiently as possible, but when the 
design was actually implemented, it turned out that the resulting program was not 
as fast as the designers had thought. The next transition is one with which you are 
surely familiar. When the program was handed to the quality assurance department 
for testing, many bugs were found that would best be fixed by reimplementing, or 
maybe even redesigning, the program, but the waterfall model did not allow for 
this. Finally, when the customers received the finished product, they were often not 
at all happy with it. Even though the customers typically were very involved in the 
analysis phase, often they themselves were not sure exactly what they needed. After 
all, it can be very difficult to describe how you want to use a product that you have 
never seen before. But when the customers started using the program, they began to 
realize what they would have liked. Of course, then it was too late, and they had to 
live with what they got. 

_ _ Having some level of iteration is clearly necessary. There simply 
must be a mechanism to deal with errors from the preceding phase. A 
spiral model, originally proposed by Barry Boehm in 1988, breaks 
the development process down into multiple phases (see Figure 2). 
Early phases focus on the construction of prototypes. A prototype 1s 
a small system that shows some aspects of the final system. Because 
prototypes model only a part of a system and do not need to withstand 


The spiral model of 
software develop 
| describes an iterati 
process in which | 
and implementatio 
repeated. ae 


Design 


Analysis Implementation 


ee #1 


Prototype #2 


Final 
Product 


Testing 


Deployment 


Figure 2 A Spiral Model 
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Inception | Elaboration| Construction Transition 
Process Workflows 


Business Modeling 
Requirements 
Analysis and Design 
Implementation 
Testing 

Deployment 
Supporting Workflows 
Configuration and 


Change Management 


Project Management 


Environment 


preliminary] iter | iter | iter | iter | iter | iter | iter 
iteration(s) | #1 | #2 #n |#n+1|#n+2| #m |#m+1 


Figure 3 Activity Levels in the Rational Unified Process Methodology [1] 


customer abuse, they can be implemented quickly. It is common to build a user 
interface prototype that shows the user interface in action. This gives customers an 
early chance to become more familiar with the system and to suggest improvements 
before the analysis is complete. Other prototypes can be built to validate interfaces 
with external systems, to test performance, and so on. Lessons learned from the 
development of one prototype can be applied to the next iteration of the spiral. 

By building in repeated trials and feedback, a development process that follows 
the spiral model has a greater chance of delivering a satisfactory system. However, 
there is also a danger. If engineers believe that they don’t have to do a good job 
because they can always do another iteration, then there will be many iterations, 
and the process will take a very long time to complete. 

, Figure 3 shows activity levels in the “Rational Unified Process”, a 
development process methodology by the inventors of UML. The 
details are not important, but as you can see, this is a complex pro- 
cess involving multiple iterations. 

Even complex development processes with many iterations have not 
always met with success. In 1999, Kent Beck published an influential 

book [2] on Extreme Programming, a development methodology that 
strives - Gap by cutting out most of the formal trappings of a traditional 
development methodolgy and instead focusing on a set of practices: 


© Realistic planning: Customers are to make business decisions, programmers are 
to make technical decisions. Update the plan when it conflicts with reality. 


* Small releases: Release a useful system quickly, then release updates on a very 
short cycle. 
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¢ Metaphor: All programmers should have a simple shared story that explains the 
system under development. 


¢ Simplicity: Design everything to be as simple as possible instead of preparing for 
future complexity. 


e Testing: Both programmers and customers are to write test cases. The system is 
continuously tested. 


¢ Refactoring: Programmers are to restructure the system continuously to improve 
the code and eliminate duplication. 


e Pair programming: Put programmers together in pairs, and require each pair to 
write code on a single computer. 


¢ Collective ownership: All programmers have permission to change all code as it 
becomes necessary. 


© Continuous integration: Whenever a task is completed, build the entire system 
and test it. 


e 40-hour week: Don’t cover up unrealistic schedules with bursts of heroic effort. 


e On-site customer: An actual customer of the system is to be accessible to team 
members at all times. 


© Coding standards: Programmers are to follow standards that emphasize self- 
documenting code. 


Many of these practices are common sense. Others, such as the pair programming 
requirement, are surprising. Beck claims that the value of the Extreme Program- 
ming approach lies in the synergy of these practices—the sum is bigger than the 
parts. 

In your first programming course, you will not develop systems that are so com- 
plex that you need a full-fledged methodology to solve your homework problems. 
This introduction to the development process should, however, show you that suc- 
cessful software development involves more than just coding. In the remainder of 
this chapter we will have a closer look at the design phase of the software develop- 
ment process. 


SELF CHECK 


1. Suppose you sign a contract, promising that you will, for an agreed-upon price, 
design, implement, and test a software package exactly as it has been specified 
in a requirements document. What is the primary risk you and your customer 
are facing with this business arrangement? 


2. Does Extreme Programming follow a waterfall or a spiral model? 


3. What is the purpose of the “on-site customer” in Extreme Programming? 
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RANDOM FACT 12.1 
Programmer Productivity 


If you talk to your friends in this programming class, you will find that some of them consis- 
tently complete their assignments much more quickly than others. Perhaps they have more 
experience. However, even when programmers with the same education and experience are 
compared, wide variations in competence are routinely observed and measured. It is not 
uncommon to have the best programmer in a team be five to ten times as productive as the 
worst, using any of a number of reasonable measures of productivity [3]. 

That is a staggering range of performance among trained professionals. In a marathon 
race, the best runner will not run five to ten times faster than the slowest one. Software prod- 
uct managers are acutely aware of these disparities. The obvious solution is, of course, to hire 
only the best programmers, but even in recent periods of economic slowdown the demand 
for good programmers has greatly outstripped the supply. 

Fortunately for all of us, joining the rank of the best is not necessarily a question of raw 
intellectual power. Good judgment, experience, broad knowledge, attention to detail, and 
superior planning are at least as important as mental brilliance. These skills can be acquired 
by individuals who are genuinely interested in improving themselves. 

Even the most gifted programmer can deal with only a finite number of details in a given 
time period. Suppose a programmer can implement and debug one method every two hours, 
or one hundred methods per month. (This is a generous estimate. Few programmers are this 
productive.) If a task requires 10,000 methods (which is typical for a medium-sized pro- 
gram), then a single programmer would need 100 months to complete the job. Such a project 
is sometimes expressed as a “100-man-month” project. But as Fred Brooks explains in his 
famous book [4], the concept of “man-month” is a myth. One cannot trade months for pro- 
grammers. One hundred programmers cannot finish the task in one month. In fact, 10 pro- 
grammers probably couldn’t finish it in 10 months. First of all, the 10 programmers need to 
learn about the project before they can get productive. Whenever there is a problem with a 
particular method, both the author and its users need to meet and discuss it, taking time 
away from all of them. A bug in one method may have other programmers twiddling their 
thumbs until it is fixed. 

It is difficult to estimate these inevitable delays. They are one reason why software is 
often released later than originally promised. What is a manager to do when the delays 
mount? As Brooks points out, adding more personnel will make a late project even later, 
because the productive people have to stop working and train the newcomers. 

You will experience these problems when you work on your first team project with other 
students. Be prepared for a major drop in productivity, and be sure to set ample time aside 
for team communications. 

There is, however, no alternative to teamwork. Most important and worthwhile projects 
transcend the ability of one single individual. Learning to function well in a team is just as 
important as becoming a competent programmer. 


536 CHAPTER 12 «#® Object-Oriented Design 


In the design phase of software development, your task is to discover structures that 
make it possible to implement a set of tasks on a computer. When you use the 
object-oriented design process, you carry out the following tasks: 


1. Discover classes. 
2. Determine the responsibilities of each class. 


3. Describe the relationships between the classes. 


A class represents some useful concept. You have seen classes for 
concrete entities, such as bank accounts, ellipses, and products. Other 
classes represent abstract concepts, such as streams and windows. 

A simple rule for finding classes is to look for nouns in the task description. For 
example, suppose your job is to print an invoice such as the one in Figure 4. Obvi- 
ous classes that come to mind are Invoice, LineItem, and Customer. It is a good idea 
to keep a list of candidate classes on a whiteboard or a sheet of paper. As you brain- 
storm, simply put all ideas for classes onto the list. You can always cross out the 
ones that weren’t useful after all. 


INVOICE 


Sam’s Small Appliances 
100 Main Street 
Anytown, CA 98765 


item Qty Price’ Total 
Toaster $29.95 $89.85 
Hair Dryer $24.95 $24.95 


Car Vacuum 2 $19.99 $39.98 


AMOUNT DUE: $154.78 


Figure 4 An Invoice 
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When finding classes, keep the following points in mind: 


e A class represents a set of objects with the same behavior. Entities with multiple 
occurrences in your problem description, such as customers or products, are 
good candidates for objects. Find out what they have in common, and design 
classes to capture those commonalities. 


e Some entities should be represented as objects, others as primitive types. For 
example, should an address be an object of an Address class, or should it simply 
be a string? There is no perfect answer—it depends on the task that you want to 
solve. If your software needs to analyze addresses (for example, to determine 
shipping costs), then an Address class is an appropriate design. However, if your 
software will never need such a capability, you should not waste time on an 
overly complex design. It is your job to find a balanced design; one that is not 
too limiting or excessively general. 


e Not all classes can be discovered in the analysis phase. Most complex programs 
need classes for tactical purposes, such as file or database access, user interfaces, 
control mechanisms, and so on. 


e Some of the classes that you need may already exist, either in the standard library 
or in a program that you developed previously. You also may be able to use 
inheritance to extend existing classes into classes that match your needs. 


Once a set of classes has been identified, you need to define the behavior for each 
class. That is, you need to find out what methods each object needs to carry out to 
solve the programming problem. A simple rule for finding these methods is to look 
for verbs in the task description, and then match the verbs to the appropriate 
objects. For example, in the invoice program, a class needs to compute the amount 
due. Now you need to figure out which class is responsible for this method. Do cus- 
tomers compute what they owe? Do invoices total up the amount due? Do the 
items total themselves up? The best choice is to make “compute amount due” the 
responsibility of the Invoice class. 

An excellent way to carry out this task is the “CRC card method.” 
CRC stands for “classes”, “responsibilities”, “collaborators”, and in 
its simplest form, the method works as follows. Use an index card for 


eee its collaborating a each class (see Figure 5). As you think about verbs in the task descrip- 


: classes. 


tion that indicate methods, you pick the card of the class that you 

think should be responsible, and write that responsibility on the card. 
For each responsibility, you record which other classes are needed to fulfill it. 
Those classes are the collaborators. 

For example, suppose you decide that an invoice should compute the amount 
due. Then you write “compute amount due” on the left-hand side of an index card 
with the title Invoice. 

If a class can carry out that responsibility by itself, do nothing further. But if the 
class needs the help of other classes, write the names of these collaborators on the 
right-hand side of the card. 

To compute the total, the invoice needs to ask each line item about its total price. 
Therefore, the LineItem class is a collaborator. 
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Class 


Responsibilities Invoice | Collaborators 


compute amount due _ LineItem 


Figure 5 A CRC Card 


This is a good time to look up the index card for the LineItem class. Does it have 
a “get total price” method? If not, add one. 

How do you know that you are on the right track? For each responsibility, ask 
yourself how it can actually be done, using the responsibilities written on the vari- 
ous cards. Many people find it helpful to group the cards on a table so that the col- 
laborators are close to each other, and to simulate tasks by moving a token (such as 
a coin) from one card to the next to indicate which object is currently active. 

Keep in mind that the responsibilities that you list on the CRC card are on a high 
level. Sometimes a single responsibility may need two or more Java methods for 
carrying it out. Some researchers say that a CRC card should have no more than 
three distinct responsibilities. 

The CRC card method is informal on purpose, so that you can be creative and 
discover classes and their properties. Once you find that you have settled on a good 
set of classes, you will want to know how they are related to each other. Can you 
find classes with common properties, so that some responsibilities can be taken care 
of by a common superclass? Can you organize classes into clusters that are inde- 
pendent of each other? Finding class relationships and documenting them with dia- 
grams is the topic of the next section. 


SELF CHECK 


4. Suppose the invoice is to be saved to a file. Name a likely collaborator. 


5. Looking at the invoice in Figure 4, what is a likely responsibility of the 
Customer class? 


6. What do you do if a CRC card has ten responsibilities? 


12.3 


: Inheritance (the is-a 
2 relationship) i is sometimes — 
wp ep rprael used when 


“Aggregation (the has-a 
relationship) denotes that _ 
objects of one class 


Relations 
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When designing a program, it is useful to document the relationships between 
classes. This helps you in a number of ways. For example, if you find classes with 
common behavior, you can save effort by placing the common behavior into a 
superclass. If you know that some classes are not related to each other, you can 
assign different programmers to implement each of them, without worrying that 
one of them has to wait for the other. 

You have seen the inheritance relationship between classes many times in this 
book. Inheritance is a very important relationship, but, as it turns out, it is not the 
only useful relationship, and it can be overused. 

Inheritance is a relationship between a more general class (the superclass) and a 
more specialized class (the subclass). This relationship is often described as the is-a 
relationship. Every truck is a vehicle. Every savings account is a bank account. 
pvely circle is an ellipse (with equal width and height). 

ae Inheritance is sometimes abused, however. For example, consider 

a Tire class that describes a car tire. Should the class Tire be a sub- 
class of a class Circle? It sounds convenient. There are quite a few 
useful methods in the Circle class—for example, the Tire class may 
inherit methods that compute the radius, perimeter, and center point, 
which should come in handy when drawing tire shapes. Though it 

may ‘Gecoaveniese Orin programmer, this arrangement makes no sense conceptu- 
ally. It isn’t true that every tire is a circle. Tires are car parts, whereas circles are geo- 
metric objects. There is a relationship between tires and circles, though. A tire has a 
circle as its boundary. Java lets us model that relationship, too. Use an instance field: 


public class Tire 


{ 


private String rating; 
private Circle boundary; 


: 


The technical term for this relationship is aggregation. Each Tire aggregates a 
Circle object. In general, a class aggregates another class if its objects have objects 
of the other class. 

Here is another example. Every car is a vehicle. Every car has a 
tire (in fact, it has four or, if you count the spare, five). Thus, you 
would use inheritance from Vehicle and use aggregation of Tire 


ae | Sheets 
contain references to 
objects of another class. public class Car extends Vehicle 


private Tire[] tires; 
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- Vehicle 


Car 


Figure 6 
UML Notation for 
Inheritance and Aggregation 


Tire 


In this book, we use the UML notation for class diagrams. You have already seen 
many examples of the UML notation for inheritance—an arrow with an open trian- 
gle pointing to the superclass. In the UML notation, aggregation is denoted by a 
solid line with a diamond-shaped symbol next to the aggregating class. Figure 6 
sea a class diagram with an inheritance and an aggregation relationship. 

The aggregation relationship is related to the dependency relation- 
ship, which you saw in Chapter 8. Recall that a class depends on 
another if one of its methods uses an object of the other class in some 
way. 

For example, many of our applications depend on the Scanner class, because they 
use a Scanner object to read input. 

Aggregation is a stronger form of dependency. If a class has objects of another 
class, it certainly uses the other class. However, the converse is not true. For exam- 
ple, a class may use the Scanner class without ever defining an instance field of class 
Scanner. The class may simply construct a local variable of type Scanner, or its 
methods may receive Scanner objects as parameters. This use is not aggregation 
because the objects of the class don’t contain Scanner objects—they just create or 
receive them for the duration of a single method. 

Generally, you need aggregation when an object needs to remem- 
ber another object between method calls. 

As you saw in Chapter 8, the UML notation for dependency is a 
dashed line with an open arrow that points to the dependent class. 

The arrows in the UML notation can get confusing. Table 1 shows 
a summary of the four UML relationship symbols that we use in this 


book. 
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Table 1 UML Relationship Symbols 


Relationship Symbol Line Style Arrow Tip 
Inheritance Saal Solid Triangle 
Interface Implementation -~-~----- > Dotted Triangle 
Aggregation tenn Solid Diamond 
Dependency -—------> Dotted Open 


SELF CHECK 


7, Consider the Bank and BankAccount classes of Chapter 7. How are they related? 


8. Consider the BankAccount and SavingsAccount objects of Chapter 10. How are 
they related? 


9. Consider the BankAccountTester class of Chapter 3. Which classes does it 
depend on? 


How To 12.1 


CRC Cards and UML Diagrams 


Before writing code for a complex problem, you need to design a solution. The methodology 
introduced in this chapter suggests that you follow a design process that is composed of the 
following tasks: 


1. Discover classes. 


2. Determine the responsibilities of each class. 
3. Describe the relationships between the classes. 


CRC cards and UML diagrams help you discover and record this information. 
Step 1. Discover classes. 


Highlight the nouns in the problem description. Make a list of the nouns. Cross out those 
that don’t seem reasonable candidates for classes. 


Step 2. Discover responsibilities. 


Make a list of the major tasks that your system needs to fulfill. From those tasks, pick one 
that is not trivial and that is intuitive to you. Find a class that is responsible for carrying out 
that task. Make an index card and write the name and the task on it. Now ask yourself how 
an object of the class can carry out the task. It probably needs help from other objects. Then 
make CRC cards for the classes to which those objects belong and write the responsibilities 
on them. 

Don’t be afraid to cross out, move, split, or merge responsibilities. Rip up cards if they 
become too messy. This is an informal process. 
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You are done when you have walked through all major tasks and are satisfied that they 
can all be solved with the classes and responsibilities that you discovered. 


Step 3. Describe relationships. 


Make a class diagram that shows the relationships between all the classes that you 
discovered. 

Start with inheritance—the is-a relationship between classes. Is any class a specialization 
of another? If so, draw inheritance arrows. Keep in mind that many designs, especially for 
simple programs, don’t use inheritance extensively. 

The “collaborators” column of the CRC cards tell you which classes use others. Draw 
usage arrows for the collaborators on the CRC cards. 

Some dependency relationships give rise to aggregations. For each of the dependency 
relationships, ask yourself: How does the object locate its collaborator? Does it navigate to it 
directly because it stores a reference? In that case, draw an aggregation arrow. Or is the col- 
laborator a method parameter or return value? Then simply draw a dependency arrow. 


ADVANCED Topic 12.1 
Attributes and Methods in UML Diagrams 


Sometimes it is useful to indicate class attributes and methods ina class diagram. An attribute 
is an externally observable property that objects of a class have. For example, name and price 
would be attributes of the Product class. Usually, attributes correspond to instance variables. 
But they don’t have to—a class may have a different way of organizing its data. For example, 
a GregorianCalendar object from the Java library has attributes day, month, and year, and it 
would be appropriate to draw a UML diagram that shows these attributes. However, the 
class doesn’t actually have instance fields that store these quantities. Instead, it internally rep- 
resents all dates by counting the milliseconds from January 1, 1970—an implementation 
detail that a class user certainly doesn’t need to know about. 

You can indicate attributes and methods in a class diagram by dividing a class rectangle 
into three compartments, with the class name in the top, attributes in the middle, and meth- 
ods in the bottom (see Attributes and Methods in a Class Diagram). You need not list all 
attributes and methods in a particular diagram. Just list the ones that are helpful to under- 
stand whatever point you are making with a particular diagram. 

Also, don’t list as an attribute what you also draw as an aggregation. If you denote by 
aggregation the fact that a Car has Tire objects, don’t add an attribute tires. 


BankAccount a seributes 
balance 
Methods 
deposit() 
withdraw() 


Attributes and Methods in a Class Diagram 
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ADVANCED TOPIC 12.2 


Multiplicities 


Some designers like to write multiplicities at the end(s) of an aggregation relationship to denote 
how many objects are aggregated. The notations for the most common multiplicities are: 


¢ any number (zero or more): * 
* one or more: 1...* 

e zero or one: 0..1 

e exactly one: 1 


The figure below shows that a customer has one or more bank accounts. 


Customer oOo _C=BarnkAcccount 


An Aggregation Relationship with Multiplicities 


ADVANCED TOPIC 12.3 


Aggregation and Association 


Some designers find the aggregation or has-a terminology unsatisfactory. For example, con- 
sider customers of a bank. Does the bank “have” customers? Do the customers “have” bank 
accounts, or does the bank “have” them? Which of these “has” relationships should be mod- 
eled by aggregation? This line of thinking can lead us to premature implementation 
decisions. 

Early in the design phase, it makes sense to use a more general relationship between 
classes called association. A class is associated with another if you can navigate from objects 
of one class to objects of the other class. For example, given a Bank object, you can navigate 
to Customer objects, perhaps by accessing an instance field, or by making a database lookup. 

The UML notation for an association relationship is a solid line, with optional arrows 
that show in which directions you can navigate the relationship. You can also add words to 
the line ends to further explain the nature of the relationship. An Association Relationship 
shows that you can navigate from Bank objects to Customer objects, but you cannot navigate 
the other way around. That is, in this particular design, the Customer class has no mechanism 
to determine in which banks it keeps its money. 


serves 
Bank ————————————————____——-_-> Customer 


An Association Relationship 
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Frankly, the differences between aggregation and association are confusing, even to expe- 
rienced designers. If you find the distinction helpful, by all means use the relationship that 
you find most appropriate. But don’t spend time pondering subtle differences between these 
concepts. From the practical point of view of a Java programmer, it is useful to know when 
objects of one class manage objects of another class. The aggregation or has-a relationship 
accurately describes this phenomenon. 


ao 12 


In this chapter, we discuss a five-part development process that is particularly well 
suited for beginning programmers: 


. Gather requirements. 
. Use CRC cards to find classes, responsibilities, and collaborators. 


1 
2 
3. Use UML diagrams to record class relationships. 
4, Use javadoc to document method behavior. 

5. 


Implement your program. 


There isn’t a lot of notation to learn. The class diagrams are simple to draw. The 
deliverables of the design phase are obviously useful for the implementation 
phase—you simply take the source files and start adding the method code. Of 
course, as your projects get more complex, you will want to learn more about for- 
mal design methods. There are many techniques to describe object scenarios, call 
sequencing, the large-scale structure of programs, and so on, that are very beneficial 
even for relatively simple projects. The Unified Modeling Language User Guide [1] 
gives a good overview of these techniques. 

In this section, we will walk through the object-oriented design technique with a 
very simple example. In this case, the methodology may feel overblown, but it is a 
good introduction to the mechanics of each step. You will then be better prepared 
for the more complex example that follows. 


The task of this program is to print out an invoice. An invoice describes the charges 
for a set of products in certain quantities. (We omit complexities such as dates, 
taxes, and invoice and customer numbers.) The program simply prints the billing 
address, all line items, and the amount due. Each line item contains the description 
and unit price of a product, the quantity ordered, and the total price. 
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INVOICE 


Sam's Small Appliances 
100 Main Street 
Anytown, CA 98765 


Description 
Toaster 

Hair dryer 
Car vacuum 


AMOUNT DUE: $154.78 


Price 
29.95 
24.95 
19.99 


NO FR W et 


Total 
89.85 
24.95 
39.98 
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Also, in the interest of simplicity, we do not provide a user interface. We just supply 


a test program that adds line items to the invoice and then prints it. 


CRC Cards 


First, you need to discover classes. Classes correspond to nouns in the requirements 


description. In this problem, it is pretty obvious what the nouns are: 


Invoice 
Address 
LineItem 
Product 
Description 
Price 
Quantity 
Total 
Amount Due 


(Of course, Toaster doesn’t count—it is the description of a LineItem object and 
therefore a data value, not the name of a class.) 
Description and price are fields of the Product class. What about the quantity? 
The quantity is not an attribute of a Product. Just as in the printed invoice, let’s have 
a class LineItem that records the product and the quantity (such as “3 toasters”). 
The total and amount due are computed —not stored anywhere. Thus, they don’t 


lead to classes. 


After this process of elimination, we are left with four candidates for classes: 


Invoice 
Address 
LineItem 
Product 


Each of them represents a useful concept, so let’s make them all into classes. 


The purpose of the program is to print an invoice. However, the Invoice class 
won’t necessarily know whether to display the output in System. out, 1n a text area, 
or ina file. Therefore, let’s relax the task slightly and make the invoice responsible 
for formatting the invoice. The result is a string (containing multiple lines) that can 


be printed out or displayed. Record that responsibility on a CRC card: 
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Invoice 


ormat the invoice 


How does an invoice format itself? It must format the billing address, format all line 
items, and then add the amount due. How can the invoice format an address? It 
can’t—that really is the responsibility of the Address class. This leads to a second 


CRC card: 


ormat the address 


Similarly, formatting of a line item is the responsibility of the LineItem class. 

The format method of the Invoice class calls the format methods of the Address 
and LineItem classes. Whenever a method uses another class, you list that other class 
as a collaborator. In other words, Address and LineItem are collaborators of Invoice: 


Invoice 


ormat the invoice Address 
LineItem 
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When formatting the invoice, the invoice also needs to compute the total amount 
due. To obtain that amount, it must ask each line item about the total price of the 
item. 

How does a line item obtain that total? It must ask the product for the unit price, 
and then multiply it by the quantity. That is, the Product class must reveal the unit 
price, and it is a collaborator of the LineItem class. 

Finally, the invoice must be populated with products and quantities, so that it 
makes sense to format the result. That too is a responsibility of the Invoice class. 

We now have a set of CRC cards that completes the CRC card process. 


get description 
get unit price 


ormat the item Product 
get total price 


Invoice 


ormat the invoice Address 
add a product and quantity LineItem 
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Use javadoc comments 


The dependency relationships come from the collaboration column on the CRC 
cards. Each class depends on the classes with which it collaborates. In our example, 
the Invoice class collaborates with the Address, LineItem, and Product classes. The 
LineItem class collaborates with the Product class. 

Now ask yourself which of these dependencies are actually aggregations. How 
does an invoice know about the address, line item, and product objects with which 
it collaborates? An invoice object must hold references to the address and the line 
items when it formats the invoice. But an invoice object need not hold a reference to 
a product object when adding a product. The product is turned into a line item, and 
then it is the item’s responsibility to hold a reference to it. 

Therefore, the Invoice class aggregates the Address and LineItem classes. The 
LineItem class aggregates the Product class. However, there is no has-a relationship 
between an invoice and a product. An invoice doesn’t store products directly — they 
are stored in the LineItem objects. 

There is no inheritance in this example. 

Figure 7 shows the class relationships that we discovered. 


et seen ingce <_— Address — 


| 


_ Product ——<_ > LineItem 


Figure 7 The Relationships Between the Invoice Classes 


Jocumentation 


The final step of the design phase is to write the documentation of 


(with the method bodies _—sthe discovered classes and methods. Simply write a Java source file 
left blank) to record the _ for each class, write the method comments for those methods that 
behavior of classes. =~: you have discovered, and leave the bodies of the methods blank. 
: | . | — [** . . 
Describes an invoice for a set of purchased products. 
* / 


public class Invoice 


{ 
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Adds a charge for a product to this invoice. 
@param aProduct the product that the customer ordered 
@param quantity the quantity of the product 

*/ 

public void add(Product aProduct, int quantity) 

: 

} 


[x 
Formats the invoice. 
@return the formatted invoice 
i 
public String format() 
{ 
} 
} 


| %* 
Describes a quantity of an article to purchase and its price. 
* / 
public class LineItem 
{ 

;}* * . . . 
Computes the total cost of this line item. 
@return the total price 

* / 

public double getTotalPrice(Q 
{ 
} 


[ee 
Formats this item. 
@return a formatted string of this line item 
— 
public String format() 
{ 
} 


/* % 
Describes a product with a description and a price. 
* / 
public class Product 
{ 
/* * . . 
Gets the product description. 
@return the description 
* 
public String getDescription() 
{ 
} 
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/* * 
Gets the product price. 
@return the unit price 


ar 
public double getPrice() 
{ 
} 
} 
[ew 
Describes a mailing address. 
si 
public class Address 
1 
[ee 
Formats the address. 
@return the address as a string with three lines 
ig 
public String format() 
: 
} 
} 


Then run the javadoc program to obtain a prettily formatted version of your docu- 
mentation in HTML format (see Figure 8). 

This approach for documenting your classes has a number of advantages. You 
can share the HTML documentation with others if you work in a team. You use a 
format that is immediately useful—Java source files that you can carry into the 
implementation phase. And, most importantly, you supply the comments of the 
key methods—a task that less prepared programmers leave for later, and then often 
neglect for lack of time. 


12.4.5 Implementation 


Finally, you are ready to implement the classes. 

You already have the method signatures and comments from the previous step. 
Now look at the UML diagram to add instance fields. Aggregated classes yield 
instance fields. Start with the Invoice class. An invoice aggregates Address and 
LineItem. Every invoice has one billing address, but it can have many line items. To 
store multiple LineItem objects, you can use an array list. Now you have the 
instance fields of the Invoice class: 


public class Invoice 


{ 


private Address billingAddress; 
private ArrayList<LineItem> items; 
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® \Invoice - Firefox 


j 
i 


File Edit View History Bookmarks Tools Help 


@- © Li filewthomelcay/Biglavalchizfinvoicefindexhtm! 


All Classes | - 
Aaanaes | Package Tree Deprecated Index Help | 
invoices | FREY CLASS NEXT CLASS FRAMES Ho FRAMES | 
InvoicePrinter SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD | 
Product . : | 

| Class Invoice | 


| java.lang.Object 
| lL Invoice 


| public class Invoice 
| extends java.lang.Object 


| Describes an invoice for a set of purchased products. 


||Constructor Summary 
| lInvoice (Address anAddress) 
Constructs an invoice, 


||Method Summary 
if void|add (Product aProduct, int quantity) 
| | Adds a charge for a product to this invoice. 
java. Lang. String] format (} 

Formats the invoice. 


{ 
double | getAmountDue ( } | 
Computes the total amount due. | 


Figure 8 The Class Documentation in HTML Format 


A line item needs to store a Product object and the product quantity. That leads to 
the following instance fields: 


public class LineItem 


{ 


private int quantity; 
private Product theProduct; 


} 


The methods themselves are now very easy. Here is a typical example. You already 
know what the getTotalPrice method of the LineItem class needs to do—get the 
unit price of the product and multiply it with the quantity. 
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/* ¥ 
Computes the total cost of this line item. 
@return the total price 


public double getTotalPrice() 
{ 


‘ 


We will not discuss the other methods in detail—they are equally straightforward. 
Finally, you need to supply constructors, another routine task. 
Here is the entire program. It is a good practice to go through it in detail and 


match up the classes and methods against the CRC cards and UML diagram. 


return theProduct.getPrice() * quantity; 


ch12/invoice/InvoicePrinter.java 


2 This program demonstrates the invoice classes by 

3 printing a sample invoice. 

4 « 

§ public class InvoicePrinter 

6 { 

f public static void main(String[] args) 

8 { 

9 Address samsAddress 
10 = new Address("'Sam’s Small Appliances", 
i @! "100 Main Street", "Anytown", "CA", "98765"); 
12 
13 Invoice samsInvoice = new Invoice(samsAddress) ; 
14 samsInvoice.add(new Product("Toaster", 29.95), 3); 
15 samsInvoice.add(new Product("Hair dryer", 24.95), 1); 
16 samsInvoice.add(new Product("Car vacuum", 19.99), 2): 
17 
18 System.out.printIlnCsamsInvoice.format()); 
19 } 
20 3} 


ch12/invoice/Invoice.java 


1 import java.util.ArrayList; 


2 
3 ri ks | 
o Describes an invoice for a set of purchased products. 
5 
6 public class Invoice 
/ { 
8 /* * 
9 Constructs an invoice. 
10 @param anAddress the billing address 
11 * / 
iz public Invoice(Address anAddress) 


13 { 
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items = new ArrayList<LineItem>() ; 
billingAddress = anAddress; 


Adds a charge for a product to this invoice. 
@param aProduct the product that the customer ordered 
@param quantity the quantity of the product 


public void add(Product aProduct, int quantity) 

{ 
LineItem anItem = new LineItem(aProduct, quantity); 
items.add(CanItem) ; 


7 
Formats the invoice. 
@return the formatted invoice 
* j 
public String format() 
{ 
String r= * INVOTIC E\n\n" 
+ billingAddress. format () 
+ String. format" \n\n%-30s%8s%55%8S\n" , 
"Description", "Price", "Qty", "Total"); 
for (LineItem 7 : items) 
{ 
r=r+i.formatQ) + "\n"; 
} 
r =r + String.format("\nAMOUNT DUE: $%8.2f", getAmountDue()) ; 
return r; 
} 
/ rabid 


Computes the total amount due. 
@return the amount due 


public double getAmountDue() 


{ 
double amountDue = 0; 
for (LineItem i : items) 
{ 
amountDue = amountDue + i.getTotalPrice(); 
} 
return amountDue; 
; 


private Address billingAddress; 
private ArrayList<LineItem> items; 
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ch12/invoice/Lineltem.java 


1 /* * 
2 Describes a quantity of an article to purchase. 
3 + 
4 public class LineItem 
5 { 
6 [we 
7 Constructs an item from the product and quantity. 
8 @param aProduct the product 
9 @param aQuantity the item quantity 
10 * / 
i] public LineItem(Product aProduct, int aQuantity) 
12 it 
13 theProduct = aProduct; 
14 quantity = aQuantity; 
15 , 
16 
17 J% * 
18 Computes the total cost of this line item. 
19 @return the total price 
20 “7 
Zi public double getTotalPrice() 
22 { 
23 return theProduct.getPrice() * quantity; 
24 } 
25 
26 je 
27 Formats this item. 
28 @return a formatted string of this line item 
29 * / 
30 public String format() 
31 { 
32 return String. format (“%-30s5%8 . 2£%5d%8.2f", 
33 theProduct.getDescription(), theProduct.getPrice(), 
34 quantity, getTotalPrice()); 
35 } 
36 
37 private int quantity; 
38 private Product theProduct: 
39} 


ch12/invoice/Product.java 


1 
2 Describes a product with a description and a price. 
3 + 
4 public class Product 
x 4 
6 /* % . 
7 Constructs a product from a description and a price. 
8 @param aDescription the product description 
9 @param aPrice the product price 
10 se 
11 public Product(String aDescription, double aPrice) 
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12 { 

13 description = aDescription; 
14 price = aPrice; 

15 } 

16 

17 [x 

18 Gets the product description. 
19 @return the description 

20 * 

21 public String getDescription() 
22 { 

23 return description; 

24 } 

25 

26 [e* 

27 Gets the product price. 

28 @return the unit price 

29 oy 

30 public double getPrice() 

a4 { 

32 return price; 

33 } 

34 

35 private String description; 
36 private double price; 

37 CY 


ch12/invoice/Address.java 


l [ex 

2 Describes a mailing address. 

3 * / 

4 public class Address 

5 { 

6 , fe 

7 Constructs a mailing address. 

8 @param aName the recipient name 

9 @param aStreet the street 

10 @param aCity the city 
il @param aState the two-letter state code 
12 @param aZip the ZIP postal code 

13 * / 

14 public Address(String aName, String aStreet, 
15 String aCity, String aState, String aZip) 
16 { 

17 name = aName; 

18 street = aStreet; 

19 city = aCity; 
20 state = aState; 
21 zip = aZip; 
22 } 


555 


556 


CHAPTER T2 #& Object-Oriented Design 


24 [** 

25 Formats the address. 

26 @return the address as a string with three lines 
Z7 * / 

28 public String format() 

29 { 

30 return name + "\n" + street + "\n" 

31 + city +", "4+ state +" " + zip; 
32 } 

33 

34 private String name; 

35 private String street; 

36 private String city; 

37 private String state; 

38 private String zip; 

39 } 

SELF CHECK 


10. Which class is responsible for computing the amount due? What are its collabo- 
rators for this task? 


11. Why do the format methods return String objects instead of directly printing to 
System.out? 


The purpose of this project is to design a simulation of an automatic teller machine 
(ATM). The ATM is used by the customers of a bank. Each customer has two 
accounts: a checking account and a savings account. Each customer also has a cus- 
tomer number and a personal identification number (PIN); both are required to 
gain access to the accounts. (In a real ATM, the customer number would be 
recorded on the magnetic strip of the ATM card. In this simulation, the customer 
will need to type it in.) With the ATM, customers can select an account (checking or 
savings). The balance of the selected account is displayed. Then the customer can 
deposit and withdraw money. This process is repeated until the customer chooses 
to exit. 

The details of the user interaction depend on the user interface that we choose for 
the simulation. We will develop two separate interfaces: a graphical interface that 
closely mimics an actual ATM (see Figure 9), and a text-based interface that allows 
you to test the ATM and bank classes without being distracted by GUI 
programming. 

In the GUI interface, the ATM has a keypad to enter numbers, a display to show 
messages, and a set of buttons, labeled A, B, and C, whose function depends on the 
state of the machine. 
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'@ First National Bank of Java (|_|O/X 


Figure 9 
Graphical User Interface 
for the Automatic Teller Machine mee — 


Specifically, the user interaction is as follows. When the ATM starts up, it expects 
a user to enter a customer number. The display shows the following message: 

Enter customer number 

A = OK 
The user enters the customer number on the keypad and presses the A button. The 
display message changes to 


Enter PIN 

A = OK 
Next, the user enters the PIN and presses the A button again. If the customer num- 
ber and ID match those of one of the customers in the bank, then the customer can 
proceed. If not, the user is again prompted to enter the customer number. 

If the customer has been authorized to use the system, then the display message 
changes to 


Select Account 


A = Checking 
B = Savings 
C = Exit 


If the user presses the C button, the ATM reverts to its original state and asks the 
next user to enter a customer number. 

If the user presses the A or B buttons, the ATM remembers the selected account, 
and the display message changes to 


Balance = balance of selected account 

Enter amount and select transaction 

A = Withdraw 

B = Deposit 

C = Cancel 
If the user presses the A or B buttons, the value entered in the keypad is withdrawn 
from or deposited into the selected account. (This is just a simulation, so no money 
is dispensed and no deposit is accepted.) Afterwards, the ATM reverts to the pre- 
ceding state, allowing the user to select another account or to exit. 

If the user presses the C button, the ATM reverts to the preceding state without 
executing any transaction. 


558 


CHAPTER T2 #& Object-Oriented Design 


In the text-based interaction, we read input from System.in instead of the but- 
tons. Here is a typical dialog: 


Enter account number: 1 

Enter PIN: 1234 

A=Checking, B=Savings, C=Quit: A 
Balance=0.0 

A=Deposit, B=Withdrawal, C=Cancel: A 
Amount: 1000 

A=Checking, B=Savings, C=Quit: C 


In our solution, only the user interface classes are affected by the choice of user 
interface. The remainder of the classes can be used for both solutions—they are 
decoupled from the user interface. 

Because this is a simulation, the ATM does not actually communicate with a 
bank. It simply loads a set of customer numbers and PINs from a file. All accounts 
are initialized with a zero balance. 


We will again follow the recipe of Section 12.2 and show how to discover classes, 
responsibilities, and relationships and how to obtain a detailed design for the ATM 
program. 

Recall that the first rule for finding classes is “Look for nouns in the problem 
description”. Here is a list of the nouns: 


ATM 

User 

Keypad 

Display 

Display message 
Button 

State 

Bank account 
Checking account 
Savings account 
Customer 
Customer number 
PIN 

Bank 


Of course, not all of these nouns will become names of classes, and we may yet dis- 
cover the need for classes that aren’t in this list, but it is a good start. 

Users and customers represent the same concept in this program. Let’s use a class 
Customer. A customer has two bank accounts, and we will require that a Customer 
object should be able to locate these accounts. (Another possible design would 
make the Bank class responsible for locating the accounts of a given customer—see 
Exercise P12,9.) 

A customer also has a customer number and a PIN. We can, of course, require 
that a customer object give us the customer number and the PIN. But perhaps that 
isn’t so secure. Instead, simply require that a customer object, when given a 
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customer number and a PIN, will tell us whether it matches its own information or 


not. 
Customer 


match number and PIN 7 


A bank contains a collection of customers. When a user walks up to the ATM and 
enters a customer number and PIN, it is the job of the bank to find the matching 
customer. How can the bank do this? It needs to check for each customer whether 
its customer number and PIN match. Thus, it needs to call the match 
number and PIN method of the Customer class that we just discovered. Because the 
find customer method calls a Customer method, it collaborates with the Customer 
class. We record that fact in the right-hand column of the CRC card. 

When the simulation starts up, the bank must also be able to read account infor- 
mation from a file. 


| find customer _ Customer 


read customers 


The BankAccount class is our familiar class with methods to get the balance and to 
deposit and withdraw money. 

In this program there is nothing that distinguishes checking accounts from sav- 
ings accounts. The ATM does not add interest or deduct fees. Therefore, we decide 
not to implement separate subclasses for checking and savings accounts. 

Finally, we are left with the ATM class itself. An important notion of the ATM 1s 
the state. The current machine state determines the text of the prompts and the 
function of the buttons. For example, when you first log in, you use the A and B 
buttons to select an account. Next, you use the same buttons to choose between 
deposit and withdrawal. The ATM must remember the current state so that it can 
correctly interpret the buttons. 
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START 


Customer number entered 


Customer 
not found 


PIN 


Customer found 


Exit selected 


completed or 
canceled 


ACCOUNT 
| | Account selected 
Transaction | | 


TRANSACT 


Figure 10 State Diagram for the ATM Class 


There are four states: 


1. START: Enter customer ID 

2. PIN: Enter PIN 

3. ACCOUNT: Select account 

4. TRANSACT: Select transaction 


To understand how to move from one state to the next, it is useful to draw a state 
diagram (Figure 10). The UML notation has standardized shapes for state diagrams. 
Draw states as rectangles with rounded corners. Draw state changes as arrows, with 
labels that indicate the reason for the change. 

The user must type a valid customer number and PIN. Then the ATM can ask 
the bank to find the customer. This calls for a select customer method. It collabo- 
rates with the bank, asking the bank for the customer that matches the customer 

- number and PIN. Next, there must be a select account method that asks the current 
customer for the checking or savings account. Finally, the ATM must carry out the 
selected transaction on the current account. 
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ATM 


re 


Of course, discovering these classes and methods was not as neat and orderly as it 
appears from this discussion. When I designed these classes for this book, it took 
me several trials and many torn cards to come up with a satisfactory design. It is 
also important to remember that there is seldom one best design. 

This design has several advantages. The classes describe clear concepts. The 
methods are sufficient to implement all necessary tasks. (I mentally walked through 
every ATM usage scenario to verify that.) There are not too many collaboration 
dependencies between the classes. Thus, I was satisfied with this design and pro- 
ceeded to the next step. 


Figure 11 shows the relationships between these classes, using the graphical user 
interface. (The console user interface uses a single class ATMSimulator instead of the 
ATMFrame and Keypad classes.) 


ATMFrame = <>—— ATM 


Keypad 


BankAccount 


Figure 11 Relationships Between the ATM Classes 
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To draw the dependencies, use the “collaborator” columns from the CRC cards. 
Looking at those columns, you find that the dependencies are as follows: 


© ATM uses Bank, Customer, and BankAccount. 
® Bank uses Customer. 


® Customer uses BankAccount. 


It is easy to see some of the aggregation relationships. A bank has customers, and 
each customer has two bank accounts. 

Does the AT class aggregate Bank? To answer this question, ask yourself whether 
an ATM object needs to store a reference to a bank object. Does it need to locate the 
same bank object across multiple method calls? Indeed it does. Therefore, aggrega- 
tion is the appropriate relationship. 

Does an ATM aggregate customers? Clearly, the ATM is not responsible for stor- 
ing all of the bank’s customers. That’s the bank’s job. But in our design, the ATM 
remembers the current customer. If a customer has logged in, subsequent com- 
mands refer to the same customer. The ATM needs to either store a reference to the 
customer, or ask the bank to look up the object whenever it needs the current cus- 
tomer. It is a design decision: either store the object, or look it up when needed. We 
will decide to store the current customer object. That is, we will use aggregation. 
Note that the choice of aggregation is not an automatic consequence of the problem 
description—it is a design decision. 

Similarly, we will decide to store the current bank account (checking or savings) 
that the user selects. Therefore, we have an aggregation relationship between ATM 
and BankAccount. 

The class diagram is a good tool to visualize dependencies. Look at the GUI 
classes. They are completely independent from the rest of the ATM system. You can 
replace the GUI with a console interface, and you can take out the Keypad class and 
use it in another application. Also, the Bank, BankAccount, and Customer classes, 
although dependent on each other, don’t know anything about the ATM class. That 
makes sense—you can have banks without ATMs. As you can see, when you ana- 
lyze relationships, you look for both the absence and presence of relationships. 


Now you are ready for the final step of the design phase: to document the classes and 
methods that you discovered. Here is a part of the documentation for the ATM class: 


/* ¥ 
An ATM that accesses a bank. 
* / 
public class ATM 
{ 
/* ¥ 
Constructs an ATM for a given bank. 
@param aBank the bank to which this ATM connects 
* / 
public ATM(Bank aBank) { } 
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Sets the current customer number 
and sets state to PIN. 

(Precondition: state is START) 
@param number the customer number 
a7 


public void setCustomerNumber(int number) { } 


J * ¥ 
Finds customer in bank. 
If found sets state to ACCOUNT else to START. 
(Precondition: state is PIN) 
@param pin the PIN of the current customer 


public void selectCustomer(int pin) { } 


/* * 
Sets current account to checking or savings. Sets 
state to TRANSACT. 
(Precondition: state is ACCOUNT or TRANSACT) 
@param account one of CHECKING or SAVINGS 


public void selectAccount(int account) { } 


Withdraws amount from current account. 
(Precondition: state is TRANSACT) 
@param value the amount to withdraw 


public void withdraw(double value) { } 


} 


Then run the javadoc utility to turn this documentation into HTML format. 
For conciseness, we omit the documentation of the other classes. 


12.5.5 Implementation 


Finally, the time has come to implement the ATM simulator. The implementation 
phase is very straightforward and should take much less tme than the design phase. 

A good strategy for implementing the classes is to go “bottom-up”. Start with 
the classes that don’t depend on others, such as Keypad and BankAccount. Then 
implement a class such as Customer that depends only on the BankAccount class. This 
“bottom-up” approach allows you to test your classes individually. You will find 
the implementations of these classes at the end of this section. 

The most complex class is the ATM class. In order to implement the methods, you 
need to define the necessary instance variables. From the class diagram, you can tell 
that the ATM has a bank object. It becomes an instance variable of the class: 


public class ATM 
: 
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private Bank theBank; 


} 


From the description of the ATM states, it is clear that we require additional 
instance variables to store the current state, customer, and bank account. 


public class ATM 


{ . 3 
private int state; 
private Customer currentCustomer; 
private BankAccount currentAccount; 
} 


Most methods are very straightforward to implement. Consider the selectCustomer 
method. From the design documentation, we have the description 


[** 
Finds customer in bank. 
If found sets state to ACCOUNT, else to START. 
(Precondition: state is PIN) 
@param pin the PIN of the current customer 


* / 
This description can be almost literally translated to Java instructions: 


public void selectCustomer(int pin) 
{ 
assert state == PIN; 
currentCustomer = theBank.findCustomer(customerNumber, pin); 
if CcurrentCustomer == null) 
state = START; 
else 
state = ACCOUNT; 
} 


We won’t go through a method-by-method description of the ATM program. You 
should take some time and compare the actual implementation against the CRC 
cards and the UML diagram. 


ch12/atm/ATM.java 
i /* * 
: An ATM that accesses a bank. 
oF 

4 public class ATM 
5 lh 
6 [** 
7 Constructs an ATM for a given bank. 
8 @param aBank the bank to which this ATM connects 
9 * / 

10 public ATM(Bank aBank) 

11 { 

12 theBank = aBank; 

13 reset(); 

14 } 
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/ wk 
Resets the ATM to the initial state. 
a A 


public void reset() 


customerNumber = -1; 
currentAccount = null; 
State = START; 


Sets the current customer number 

and sets state to PIN. 

(Precondition: state is START) 

@param number the customer number 
* / 


public void setCustomerNumber (int number) 


assert state == START; 
customerNumber = number; 


state = PIN; 
} 
j* 
Finds customer in bank. 
If found, sets state to ACCOUNT, else to START. 
(Precondition: state is PIN) 
@param pin the PIN of the current customer 
* / 
public void selectCustomer(int pin) 
{ 
assert state == PIN; 
currentCustomer = theBank.findCustomer(customerNumber, pin); 
if CcurrentCustomer == null) 
State = START; 
else 
State = ACCOUNT; 
} 
{= 
Sets current account to checking or savings. Sets 
state to TRANSACT. 
(Precondition: state is ACCOUNT or TRANSACT) 
@param account one of CHECKING or SAVINGS 
% / 
public void selectAccount(int account) 
{ 


assert state == ACCOUNT || state == TRANSACT; 
if Caccount == CHECKING) 

currentAccount = currentCustomer.getCheckingAccount() ; 
else 

CcurrentAccount = currentCustomer.getSavingsAccount() ; 
State = TRANSACT; 
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Withdraws amount from current account. 
(Precondition: state is TRANSACT) 
@param value the amount to withdraw 
a A 
public void withdraw(double value) 
{ 
assert state == TRANSACT; 
currentAccount.withdraw(value); 


Deposits amount to current account. 
(Precondition: state is TRANSACT) 
@param value the amount to deposit 
ve 7 
public void deposit(Cdouble value) 
: 
assert state == TRANSACT; 
currentAccount.deposit(value) ; 


Gets the balance of the current account. 
(Precondition: state is TRANSACT) 
@return the balance 


es 7. 
public double getBalance() 
i 
assert state == TRANSACT; 
return currentAccount.getBalance() ; 


} 


Moves back to the previous state. 


a 
public void back() 
{ 
if (state == TRANSACT) 
State = ACCOUNT; 
else if (state == ACCOUNT) 
State = PIN; 
else if (state == PIN) 
State = START; 
} 


/* * 
Gets the current state of this ATM. 
@return the current state 

ay 6 

public int getState() 

{ 
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123 return state; 
124 } 
125 
126 private int state; 
127 private int customerNumber; 
128 private Customer currentCustomer; 
129 private BankAccount currentAccount; 
130 private Bank theBank; 
131 
132 public static final int START = 1; 
133 public static final int PIN = ?; 
134 public static final int ACCOUNT = 3; 
135 public static final int TRANSACT = 4; 
136 
137 public static final int CHECKING = 1; 
138 public static final int SAVINGS = ?; 
139 3} 
ch12/atm/Bank.java 
1 import java.io.FileReader; 
2 import java.io. IOException; 
3 import java.util.ArrayList; 
4 import java.util.Scanner; 
5 
6 
7 A bank contains customers with bank accounts. 
8 « 
9 public class Bank 
10 { 
ll | 
iz Constructs a bank with no customers. 
13 ae 
14 public Bank() 
15 if 
16 customers = new ArrayList<Customer>() ; 
17 } 
18 
19 jes 
20 Reads the customer numbers and pins 
21 and initializes the bank accounts. 
- @param filename the name of the customer fle 
3 ai 
24 public void readCustomers(String filename) 
25 throws IOException 
26 { 
27 Scanner in = new Scanner(new FileReader(filename)); 
28 while Cin. hasNext()) 
29 { 
30 int number = in.nextInt(); 
31 int pin = in.nextInt(); 
32 Customer c = new Customer(number, pin); 


33 addCustomer(c); 
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in.closeQ); 


Adds a customer to the bank. 
@param c the customer to add 


* vi 
public void addCustomer(Customer c) 
{ 
customers.add(c); 
} 
/ rides 


Finds a customer in the bank. 

@param aNumber a customer number 

@param aPin a personal identification number 

@return the matching customer, or nul] if no customer 

matches 
afd 
public Customer findCustomer(int aNumber, int aPin) 
{ 

for (Customer c : customers) 

{ 

if Cc.matchCaNumber, aPin)) 
return C; 
} 


return null; 
} 


private ArrayList<Customer> customers; 


ch12/atm/Customer.java 


2 A bank customer with a checking and a savings account. 
a 
4 public class Customer 
5 { 
6 eee 
7 Constructs a customer with a given number and PIN. 
8 @param aNumber the customer number 
9 @param aPin the personal identification number 
10 ‘ 
11 public Customer(int aNumber, int aPin) 
12 { 
13 CustomerNumber = aNumber; 
14 pin = aPin; 
15 checkingAccount = new BankAccountQ() ; 
16 SavingsAccount = new BankAccount(); 
17 } 


12.5 


19 
20 


The following class implements a console user interface for the ATM. 
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Tests if this customer matches a customer number 

and PIN. 

@param aNumber a customer number 

@param aPin a personal identification number 
@Greturn true if the customer number and PIN match 
% / 

public boolean match(int aNumber, int aPin) 


{ 
} 


return customerNumber == aNumber && pin == aPin; 


wa 


Gets the checking account of this customer. 
@return the checking account 
* / 
public BankAccount getCheckingAccount() 
: 


j ke 


Gets the Kili account of this customer. 
@return the checking account 


return checkingAccount; 


public BankAccount getSavingsAccount() 


{ 
} 


return SavingsAccount; 


private int customerNumber; 

private int pin; 

private BankAccount checkingAccount; 
private BankAccount savingsAccount; 


ch12/atm/ATMSimulator.java 


* / 
public class ATMSimulator 


import java.io.IOException; 
import java.util.Scanner; 


ale ale 
awe 


A text-based simulation of an automatic teller machine. 


public static void main(String[] args) 
{ 

ATM theATM; 

try 

{ 
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Bank theBank = new Bank(); 
theBank. readCustomers(C'"customers.txt"); 
theATM = new ATMCtheBank) ; 


catchCIOException e) 


{ 


} 


System.out.printInC"Error opening accounts file."); 


return; 


Scanner in = new Scanner(System. in); 


while (true) 


i 


int state = theATM.getStateQ(); 

if Cstate == ATM.START) 

{ 
System.out.printC"Enter customer number: "); 
int number = in.nextIntQ; 
theATM. setCustomerNumber (number) ; 


} 

else if (state == ATM.PIN) 

{ 
System.out.printC"Enter PIN: "); 
int pin = in.nextIntQ; 
theATM.selectCustomer (pin) ; 


} 
else if (state == ATM.ACCOUNT) 
{ 
System.out.printC"A=Checking, B=Savings, C=Quit: "); 
String command = in.next(); 
if Ccommand.equalsIgnoreCase(''A"')) 
theATM.selectAccount (ATM. CHECKING) ; 
else if Ccommand.equalsIgnoreCase(''B")) 
theATM.selectAccount (ATM. SAVINGS) ; 
else if Ccommand.equalsIgnoreCase('"'C'')) 
theATM.resetQ) ; 
else 
System.out.printInC"Il]legal input!"); 


; 
else if (state == ATM. TRANSACT) 
if 
System.out.printInC'Balance="" + theATM.getBalance()); 
System.out.print("A=Deposit, B=Withdrawal, C=Cancel: "); 
String command = in.next(); 
if Ccommand. equal sIgnoreCase("'A")) 
{ 
System.out.printC"Amount: "); 
double amount = in.nextDoubleQ(); 
theATM.deposit(Camount) ; 
theATM.back() ; 


else if Ccommand.equalsIgnoreCase(''B")) 


{ 
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68 System.out.print("Amount: "); 

69 double amount = in.nextDouble(); 

70 theATM.withdraw(amount) ; 

71 theATM.back(); 

72 } 

73 else if Ccommand.equalsIgnoreCase('"'C")) 
74 theATM.back(); 

75 else 

76 System.out.printInC'Illegal input!"); 
Ti } 

78 } 

79 } 

80} 

Output 


Enter account number: 1 

Enter PIN: 1234 

A=Checking, B=Savings, C=Quit: A 
Balance=0.0 

A=Deposit, B=Withdrawal, C=Cancel: A 
Amount: 1000 

A=Checking, B=Savings, C=Quit: C 


Here are the user interface classes for the GUI version of the user interface. 


ch12/atm/ATMViewer.java 


1 import java.io. IOException; 
2 import javax.swing.JFrame; 
3 import javax.swing.JOptionPane; 
4 
5 Ww 
6 A graphical simulation of an automatic teller machine. 
ri 
8 public class ATMViewer 
9 { 
10 public static void main(String[] args) 
11 { 
12 ATM theATM; 
13 
14 try 
15 { 
16 Bank theBank = new Bank(); 
17 theBank.readCustomers("customers.txt"); 
18 theATM = new ATM(theBank) ; 
19 } 
20 catch(IOException e) 
21 if 
Pa JOptionPane. showMessageDialog(nul1, 
23 "Error opening accounts file."); 


24 return; 
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28 
29 
30 
31 
a2. } 
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JFrame frame = new ATMFrame(theATM) ; 
frame.setTitleC"First National Bank of Java"); 
frame.setDefaultCloseOperation(JFrame.EXIT_ON CLOSE); 
frame.setVisible(true) ; 


ch12/atm/ATMFrame.java 


import 
import 
import 
import 
import 
import 
import 
import 


J ale ate 
aS 


% / 
public 
{ 

- weve 


* / 
pub 
{ 


java.awt.FlowLayout; 
java.awt.GridLayout; 
java.awt.event.ActionEvent; 
java.awt.event.ActionListener; 
jJavax.swing. JButton; 
javax.swing. JFrame; 
javax.swing. JPanel; 
javax.swing.JTextArea; 


A frame displaying the components of an ATM. 


class ATMFrame extends JFrame 


Constructs the user interface of the ATM frame. 
lic ATMFrame(ATM anATM) 
theATM = anAIM; 


// Construct components 
pad = new KeyPad(); 


display = new JTextArea(4, 20); 


aButton = new JButton(" A _ '"); 
aButton.addActionListener(new AButtonListener()); 


bButton = new JButton(" B "); 
bButton.addActionListener(new BButtonListener()); 


cButton = new JButton('" C "); 
cButton.addActionListener(new CButtonListener()); 


// Add components 


JPanel buttonPanel = new JPanel(); 
buttonPanel.add(aButton) ; 
buttonPanel.add(bButton) ; 
buttonPanel.add(cButton) ; 


Case Study: An Automatic Teller Machine 


setLayout(new FlowLayout()); 
add(pad) ; 

add(display) ; 
add(buttonPanel) ; 
showState() ; 


setSizeC(FRAME_WIDTH, FRAME HEIGHT) ; 


Updates display message. 


public void showState() 
{ 
int state = theATM.getState(); 
pad.clear(); 
if Cstate == ATM.START) 
display.setTextC"Enter customer number\nA = OK"); 
else if (state == ATM.PIN) 
display.setTextC"Enter PIN\nA = OK"); 
else if (state == ATM.ACCOUNT) 
display.setTextC"Select Account\n" 
+ "A = Checking\nB = Savings\nC = Exit"); 
else if (state == ATM.TRANSACT) 
display.setTextC'Balance = " 
+ theATM.getBalance() 
+ "\nEnter amount and select transaction\n" 
+ "A = Withdraw\nB = Deposit\nC = Cancel"); 
} 


private class AButtonListener implements ActionListener 
{ 
public void actionPerformed(ActionEvent event) 
{ 
int state = theATM.getState(); 
if Cstate == ATM.START) 
theATM.setCustomerNumber(Cint) pad.getValue()); 
else if (state == ATM.PIN) 
theATM.selectCustomer(Cint) pad.getValueQ)); 
else if (state == ATM.ACCOUNT) 
theATM. selectAccount (ATM. CHECKING) ; 
else if (state == ATM.TRANSACT) 


theATM.withdraw(pad.getValue()); 
theATM.back() ; 


showState() ; 


: 


private class BButtonListener implements ActionListener 


{ 


public void actionPerformed(ActionEvent event) 


{ 
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97 int state = theATM.getState(); 
98 if (state == ATM.ACCOUNT) 
99 theATM. selectAccount (ATM. SAVINGS) ; 
100 else if (state == ATM. TRANSACT) 
101 if 
102 theATM. deposit (pad. getValue()); 
103 theATM. back(); 
104 } 
105 showState(); 
106 } 
107 } 
108 
109 private class CButtonListener implements ActionListener 
110 { 
lil public void actionPerformed(ActionEvent event) 
112 { 
113 int state = theATM.getState(); 
114 if (state == ATM.ACCOUNT) 
115 theATM. reset(); 
116 else if (state == ATM. TRANSACT) 
117 theATM.back() ; 
118 showState(); 
119 } 
120 } 
121 
122 private JButton aButton; 
123 private JButton bButton; 
124 private JButton cButton; 
125 
126 private KeyPad pad; 
127 private JTextArea display; 
128 
129 private ATM theATM; 
130 
131 private static final int FRAME WIDTH = 300; 
132 private static final int FRAME HEIGHT = 300; 
133 } 


This class uses layout managers to arrange the text field and the keypad buttons. 
See Chapter 18 for more information about layout managers. 


ch12/atm/KeyPad.java 


import java.awt.BorderLayout; 

import java.awt.GridLayout; 

import java.awt.event.ActionEvent; 
import java.awt.event.ActionListener; 
import javax.swing.JButton; 

import jJavax.swing.JPanel; 

import javax.swing.JTextField; 


CON HV WN 
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9 / 
10 A component that lets the user enter a number, using 
11 a keypad labeled with digits. 
12 */ 
13 public class KeyPad extends JPanel 
14 { 
15 [xe 
16 Constructs the keypad panel. 
17 % / 
18 public KeyPad() 
19 { 
20 setLayout(new BorderLayoutQ) ; 
21 
22 // Add display field 
23 
24 display = new JTextFieldQ; 
25 add(display, "North"); 
26 
27 // Make button panel 
28 
29 buttonPanel = new JPanel(); 
30 buttonPanel.setLayout(new GridLayout(@, 3)); 
31 
32 // Add digit buttons 
33 
34 addButton('"'7"); 
35 addButton('"'8"); 
36 addButton("'9"'); 
37 addButton("4"); 
38 addButton('"'5"); 
39 addButton(''6"); 
40 addButton("1"); 
41 addButton('"'2"); 
42 addButton(''3"'); 
43 addButton("'0"); 
44 addButton("."'); 
45 
46 // Add clear entry button 
47 
48 CclearButton = new JButtonC"CE"); 
49 buttonPanel.add(clearButton) ; 
50 
51 class ClearButtonListener implements ActionListener 
52 if 
53 public void actionPerformed(ActionEvent event) 
54 { 
55 display.setText(''"'); 
56 } 
57 y 
58 ActionListener listener = new ClearButtonListener() ; 
59 
60 clearButton.addActionListener (new 
61 ClearButtonListener()); 
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63 add(buttonPanel, "Center"); 
64 } 
65 
66 pu 
67 Adds a button to the button panel. 
68 @param label the button label 
69 af 
70 private void addButton(final String label) 
71 { 
Fe class DigitButtonListener implements ActionListener 
73 af 
74 public void actionPerformed(ActionEvent event) 
75 { 
76 
77 // Don’t add two decimal points 
78 if Clabel.equals(".") 
79 && display.getText().indexOf(".") != -1) 
80 return; 
81 
82 // Append label text to button 
83 display.setText(display.getText() + label); 
&4 ; 
85 } 
86 
87 JButton button = new JButton(label); 
88 buttonPanel.add(button) ; 
89 ActionListener listener = new DigitButtonListener(); 
90 button.addActionListener(listener); 
91 } 
92 
93 a 
94 Gets the value that the user entered. 
95 @return the value in the text field of the keypad 
96 it 4 
97 public double getValue() 
98 { 
99 return Double.parseDouble(display.getText()); 
100 } 
101 
102 ae 
103 Clears the display. 
104 “7 
105 public void clearQ 
106 if 
107 display.setText("""); 
108 } 
109 
110 private JPanel buttonPanel; 
LLL private JButton clearButton; 
112 private JTextField display; 
113} 


In this chapter, you learned a systematic approach for building a relatively complex 
program. However, object-oriented design is definitely not a spectator sport. To 
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really learn how to design and implement programs, you have to gain experience by 
repeating this process with your own projects. It is quite possible that you don’t 
immediately home in on a good solution and that you need to go back and 
reorganize your classes and responsibilities. That is normal and only to be expected. 
The purpose of the object-oriented design process is to spot these problems in the 
design phase, when they are still easy to rectify, instead of in the implementation 
phase, when massive reorganization is more difficult and time consuming. 


SELF CHECK 


12. Why does the Bank class in this example not store an array list of bank accounts? 


13. Suppose the requirements change—you need to save the current account bal- 
ances to a file after every transaction and reload them when the program starts. 
What is the impact of this change on the design? 


RANDOM FACT 12.2 


Software Development—Art or Science? 


There has been a long discussion whether the discipline of computing 1s a science or not. We 
call the field “computer science”, but that doesn’t mean much. Except possibly for librarians 
and sociologists, few people believe that library science and social science are scientific 
endeavors. 

A scientific discipline aims to discover certain fundamental principles dictated by the laws 
of nature. It operates on the scientific method: by posing hypotheses and testing them with 
experiments that are repeatable by other workers in the field. For example, a physicist may 
have a theory on the makeup of nuclear particles and attempt to confirm or refute that the- 
ory by running experiments in a particle collider. If an experiment cannot be confirmed, such 
as the “cold fusion” research in the early 1990s, then the theory dies a quick death. 

Some software developers indeed run experiments. They try out various methods of com- 
puting certain results or of configuring computer systems, and measure the differences in 
performance. However, their aim is not to discover laws of nature. 

Some computer scientists discover fundamental principles. One class of fundamental 
results, for instance, states that it is impossible to write certain kinds of computer programs, 
no matter how powerful the computing equipment is. For example, it is impossible to write a 
program that takes as its input any two Java program files and as its output prints whether or 
not these two programs always compute the same results. Such a program would be very 
handy for grading student homework, but nobody, no matter how clever, will ever be able to 
write one that works for all input files. However, the majority of computer scientists are not 
researching the limits of computation. 

Some people view software development as an art or craft. A programmer who writes ele- 
gant code that is easy to understand and runs with optimum efficiency can indeed be consid- 
ered a good craftsman. Calling it an art is perhaps far-fetched, because an art object requires an 
audience to appreciate it, whereas the program code is generally hidden from the program user. 

Others call software development an engineering discipline. Just as mechanical engineering 
is based on the fundamental mathematical principles of statics, computing has certain mathe- 
matical foundations. There is more to mechanical engineering than mathematics, such as 
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knowledge of materials and of project planning. The same is true for computing. A software 
engineer needs to know about planning, budgeting, design, test automation, documentation, 
and source code control, in addition to computer science subjects, such as programming, 
algorithm design, and database technologies. 

In one somewhat worrisome aspect, software development does not have the same stand- 
ing as other engineering disciplines. There is little agreement as to what constitutes profes- 
sional conduct in the computer field. Unlike the scientist, whose main responsibility is the 
search for truth, the software developer must strive to satisfy the conflicting demands of 
quality, safety, and economy. Engineering disciplines have professional organizations that 
hold their members to standards of conduct. The computer field is so new that in many cases 
we simply don’t know the correct method for achieving certain tasks. That makes it difficult 
to set professional standards. 

What do you think? From your limited experience, do you consider software develop- 
ment an art, a craft, a science, or an engineering activity? 


CHAPTER SUMMARY 


1. The lite cycle of software encompasses all activities from initial analysis until 
obsolescence. 


2. A formal process for software development describes phases of the develop- 
ment process and gives guidelines for how to carry out the phases. 


3. The waterfall model of software development describes a sequential process of 
analysis, design, implementation, testing, and deployment. 


4. The spiral model of software development describes an iterative process in 
which design and implementation are repeated. 


5. Extreme Programming 1s a development methodology that strives for simplic- 
ity by removing formal structure and focusing on best practices. 


6. In object-oriented design, you discover classes, determine the responsibilities of 
classes, and describe the relationships between classes. 


7. A CRC card describes a class, its responsibilities, and its collaborating classes. 


8. Inheritance (the is-a relationship) is sometimes inappropriately used when the 
has-a relationship would be more appropriate. 


9. Aggregation (the /as-a relationship) denotes that objects of one class contain 
references to objects of another class. 


10. Dependency is another name for the “uses” relationship. 


11. You need to be able to distinguish the UML notations for inheritance, interface 
implementation, aggregation, and dependency. 


12. Use javadoc comments (with the method bodies left blank) to record the 
behavior of classes. 


Review Exercises 579 


FURTHER READING 


1. Grady Booch, James Rumbaugh, and Ivar Jacobson, The Unified Modeling Language 
User Guide, Addison-Wesley, 1999. 


2. Kent Beck, Extreme Programming Explained, Addison-Wesley, 1999. 


3. W.H. Sackmann, W. J. Erikson, and E. E. Grant, “Exploratory Experimental Studies 
Comparing Online and Offline Programming Performance”, Communications of the 
ACM, vol. 11, no. 1 (January 1968), pp. 3-11. 


4. EF Brooks, The Mythical Man-Month, Addison-Wesley, 1975. 


REVIEW EXERCISES 
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Exercise R12.1. What is the software life cycle? 


Exercise R12.2. List the steps in the process of object-oriented design that this chap- 
ter recommends for student use. 


Exercise R12.3. Give a rule of thumb for how to find classes when designing a 
program. 


Exercise R12.4. Give a rule of thumb for how to find methods when designing a 
program. 


Exercise R12.5. After discovering a method, why is it important to identify the 
object that is responsible for carrying out the action? 


Exercise R12.6. What relationship is appropriate between the following classes: 
aggregation, inheritance, or neither? 
a. University—Student 
. Student-—TeachingAssistant 
Student—Freshman 
. Student—Professor 
Car—Door 
Truck—-Vehicle 
. Traffic—TrafficSign 


7, mt oa st 


. TrafficSign—Color 


Exercise R12.7. Every BMW is a vehicle. Should a class Bmw inherit from the class 
Vehicle? BMW is a vehicle manufacturer. Does that mean that the class BMW should 
inherit from the class VehicleManufacturer? 


Exercise R12.8. Some books on object-oriented programming recommend using 
inheritance so that the class Circle extends the class Point. Then the Circle class 
inherits the setLocation method from the Point superclass. Explain why the 
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setLocation method need not be redefined in the subclass. Why is it nevertheless 
not a good idea to have Circle inherit from Point? Conversely, would inheriting 
Point from Circle fulfill the zs-a rule? Would it be a good idea? 


Exercise R12.9. Write CRC cards for the Coin and CashRegister classes described in 
Section 8.2. 


Exercise R12.10. Write CRC cards for the Bank and BankAccount classes in Section 7.2. 


Exercise R12.11. Draw a UML diagram for the Coin and CashRegister classes 
described in Section 8.2. 


Exercise R12.12. A file contains a set of records describing countries. Each record 
consists of the name of the country, its population, and its area. Suppose your task 
is to write a program that reads in such a file and prints 


e The country with the largest area 
e The country with the largest population 
¢ The country with the largest population density (people per square kilometer) 


Think through the problems that you need to solve. What classes and methods will 
you need? Produce a set of CRC cards, a UML diagram, and a set of javadoc 
comments. 


Exercise R12.13. Discover classes and methods for generating a student report card 
that lists all classes, grades, and the grade point average for a semester. Produce a set 
of CRC cards, a UML diagram, and a set of javadoc comments. 


Exercise R12.14. Consider a quiz grading system that grades student responses to 
quizzes. A quiz consists of questions. There are different types of questions, includ- 
ing essay questions and multiple-choice questions. Students turn in submissions for 
quizzes, and the grading system grades them. Draw a UML diagram for classes 
Quiz, Question, EssayQuestion, MultipleChoiceQuestion, Student, and Submission. 


Additional review exercises are available in WileyPLUS. 


PROGRAMMING EXERCISES 


Exercise P12.1. Enhance the invoice-printing program by providing for two kinds of 
line items: One kind describes products that are purchased in certain numerical 
quantities (such as “3 toasters”), another describes a fixed charge (such as “shipping: 
$5.00”). Hint: Use inheritance. Produce a UML diagram of your modified 
implementation. 


Exercise P12.2. The invoice-printing program is somewhat unrealistic because the 
formatting of the LineItem objects won’t lead to good visual results when the prices 
and quantities have varying numbers of digits. Enhance the format method in two 
ways: Accept an int[] array of column widths as a parameter. Use the NumberFormat 
class to format the currency values. 
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Exercise P12.3. The invoice-printing program has an unfortunate flaw —it mixes 
“business logic”, the computation of total charges, and “presentation”, the visual 
appearance of the invoice. To appreciate this flaw, imagine the changes that would 
be necessary to draw the invoice in HTML for presentation on the Web. 
Reimplement the program, using a separate InvoiceFormatter class to format the 
invoice. That is, the Invoice and LineItem methods are no longer responsible for 
formatting. However, they will acquire other responsibilities, because the Invoice- 
Formatter class needs to query them for the values that it requires. 


Exercise P12.4. Write a program that teaches arithmetic to your younger brother. 
The program tests addition and subtraction. In level 1 it tests only addition of num- 
bers less than 10 whose sum is less than 10. In level 2 it tests addition of arbitrary 
one-digit numbers. In level 3 it tests subtraction of one-digit numbers with a non- 
negative difference. Generate random problems and get the player input. The player 
gets up to two tries per problem. Advance from one level to the next when the 
player has achieved a score of five points. 


Exercise P12.5. Design a simple e-mail messaging system. A message has a recipient, 
a sender, and a message text. A mailbox can store messages. Supply a number of 
mailboxes for different users and a user interface for users to log in, send messages 
to other users, read their own messages, and log out. Follow the design process that 
was described in this chapter. 


Exercise P12.6. Write a program that simulates a vending machine. Products can be 
purchased by inserting coins with a value at least equal to the cost of the product. A 
user selects a product from a list of available products, adds coins, and either gets 
the product or gets the coins returned if insufficient money was supplied or if the 
product is sold out. The machine does not give change if too much money was 
added. Products can be restocked and money removed by an operator. Follow the 
design process that was described in this chapter. Your solution should include a 
class VendingMachine that is not coupled with the Scanner or PrintStream classes. 


Exercise P12.7. Write a program to design an appointment calendar. An appointment 
includes the date, starting time, ending time, and a description; for example, 


Dentist 2007/10/1 17:30 18:30 

CS1 class 2007/10/2 08:30 10:00 
Supply a user interface to add appointments, remove canceled appointments, and 
print out a list of appointments for a particular day. Follow the design process that 
was described in this chapter. Your solution should include a class Appointment- 
Calendar that is not coupled with the Scanner or PrintStream classes. 


Exercise P12.8. Airline seating. Write a program that assigns seats on an airplane. 
Assume the airplane has 20 seats in first class (5 rows of 4 seats each, separated by an 
aisle) and 90 seats in economy class (15 rows of 6 seats each, separated by an aisle). 
Your program should take three commands: add passengers, show seating, and quit. 
When passengers are added, ask for the class (first or economy), the number of pas- 
sengers traveling together (1 or 2 in first class; 1 to 3 in economy), and the seating 
preference (aisle or window in first class; aisle, center, or window in economy). 
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Then try to find a match and assign the seats. If no match exists, print a message. 
Your solution should include a class Airplane that is not coupled with the Scanner 
or PrintSream classes. Follow the design process that was described in this chapter. 


Exercise P12.9. Modify the implementations of the classes in the ATM example so 
that the bank manages a collection of bank accounts and a separate collection of 
customers. Allow joint accounts in which some accounts can have more than one 
customer. 


Exercise P12.10. Write a program that administers and grades quizzes. A quiz con- 
sists of questions. There are four types of questions: text questions, number ques- 
tions, choice questions with a single answer, and choice questions with multiple 
answers. When grading a text question, ignore leading or trailing spaces and letter 
case. When grading a numeric question, accept a response that is approximately the 
same as the answer. 


A quiz is specified in a text file. Each question starts with a letter indicating the 
question type (T, N, S, M), followed by a line containing the question text. The next 
line of a non-choice question contains the answer. Choice questions have a list of 
choices that is terminated by a blank line. Each choice starts with + (correct) or 

- (incorrect). Here is a sample file: 


+ 
Which Java keyword is used to define a subclass? 
extends 

S 

What 1s the original name of the Java language? 
- *7 

oe Cox 

+ Oak 

- Gosling 


M 

Which of the following types are supertypes of Rectangle? 
- PrintStream 

+ Shape 

+ RectangularShape 

+ Object 

- String 


N 
What is the square root of 2? 
1.41421356 


Your program should read in a quiz file, prompt the user for responses to all ques- 
tions, and grade the responses. Follow the design process that was described in this 
chapter. 


Exercise P12.11. Implement a program to teach your baby sister to read the clock. In 
the game, present an analog clock, such as the one in Figure 12. Generate random 

times and display the clock. Accept guesses from the player. Reward the player for 
correct guesses. After two incorrect guesses, display the correct answer and make a 
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new random time. Implement several levels of play. In level 1, only show full hours. 
In level 2, show quarter hours. In level 3, show five-minute multiples, and in level 4, 
show any number of minutes. After a player has achieved five correct guesses at one 
level, advance to the next level. 


Figure 12 An Analog Clock 


Exercise P12.12. Write a program that can be used to design a suburban scene, with 
houses, streets, and cars. Users can add houses and cars of various colors to a street. 
Write more specific requirements that include a detailed description of the user 
interface. Then, discover classes and methods, provide UML diagrams, and imple- 
ment your program. 


Exercise P12.13. Write a simple graphics editor that allows users to add a mixture of 
shapes (ellipses, rectangles, and lines in different colors) to a panel. Supply com- 
mands to load and save the picture. Discover classes, supply a UML diagram, and 
implement your program. 


Additional programming exercises are available in WileyPLUS. 
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Project 12.1. Produce a requirements document for a program that allows a com- 
pany to send out personalized mailings, either by e-mail or through the postal ser- 
vice. Template files contain the message text, together with variable fields (such as 
Dear [Title] [Last Name] . . .). A database (stored as a text file) contains the field val- 
ues for each recipient. Use HTML as the output file format. Then design and imple- 
ment the program. 


Project 12.2. Write a tic-tac-toe game that allows a human player to play against the 
computer. Your program will play many turns against a human opponent, and it 

will learn. When it is the computer’s turn, the computer randomly selects an empty 
field, except that it won’t ever choose a losing combination. For that purpose, your 
program must keep an array of losing combinations. Whenever the human wins, the 
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immediately preceding combination is stored as losing. For example, suppose that 
X = computer and O = human. Suppose the current combination is 


O} X} X 


Now it is the human’s turn, who will of course choose 


O| X | X 


O 
The computer should then remember the preceding combination 


O| X | X 


as a losing combination. As a result, the computer will never again choose that 
combination from 


or 


Discover classes and supply a UML diagram before you begin to program. 
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ANSWERS TO SELF-CHECK QUESTIONS 


1. 


It is unlikely that the customer did a perfect job with the requirements docu- 
ment. If you don’t accommodate changes, your customer may not like the out- 
come. If you charge for the changes, your customer may not like the cost. 


An “extreme” spiral model, with lots of iterations. 


3. To give frequent feedback as to whether the current iteration of the product fits 


customer needs. 
FileWriter 
To produce the shipping address of the customer. 


Reword the responsibilities so that they are at a higher level, or come up with 
more classes to handle the responsibilities. 


7. Through aggregation. The bank manages bank account objects. 


8. Through inheritance. 


10. 


12. 


13. 


The BankAccount, System, and PrintStream classes. 


The Invoice class is responsible for computing the amount due. It collaborates 
with the LineItem class. 


. This design decision reduces coupling. It enables us to reuse the classes when 


we want to show the invoice in a dialog box or on a web page. 


The bank needs to store the list of customers so that customers can log in. We 
need to locate all bank accounts of a customer, and we chose to simply store 
them in the customer class. In this program, there is no further need to access 
bank accounts. 


The Bank class needs to have an additional responsibility: to load and save the 
accounts. The bank can carry out this responsibility because it has access to the 
customer objects and, through them, to the bank accounts. 


Chapter 


Recursion 


® To learn Vineet tee method of recursion 


_ © To understand the relationship between recursion and iteration 


a hy To analyze prep is t that are much easier to solve by recursion 


nk le icively’ 


I ere recu rsive helper methods 


* 16 paderciard when the use of recursion affects t the efficiency 
of an algorithm 


The method of recursion is a powerful technique to break up complex computa- 
tional problems into simpler ones. The term “recursion” refers to the fact that the 
same computation recurs, or occurs repeatedly, as the problem is solved. Recursion 
is often the most natural way of thinking about a problem, and there are some 
computations that are very difficult to perform without recursion. This chapter 
shows you simple and complex examples of recursion and teaches you how to 


“think recursively”. 
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We begin this chapter with a very simple example that demonstrates the power of 
thinking recursively. In this example, we will look at triangle shapes such as the 
ones from Section 6.3. We'd like to compute the area of a triangle of width x, 
assuming that each [] square has area 1. This value is sometimes called the n” trian- 
gle number. For example, as you can tell from looking at 


[] 

CIC] 

CICIC] 
the third triangle number is 6. 

You may know that there is a very simple formula to compute these numbers, 
but you should pretend for now that you don’t know about it. The ultimate pur- 
pose of this section is not to compute triangle numbers, but to learn about the con- 
cept of recursion in a simple situation. 

Here is the outline of the class that we will develop: 


public class Triangle 


{ 
public TriangleCint aWidth) 
{ 
width = aWidth; 
} 
public int getArea() 
{ 
} 
private int width; 
} 


If the width of the triangle is 1, then the triangle consists of a single square, and its 
area is 1. Let’s take care of this case first. 
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public int getArea() 
{ 


if (width == 1) return 1; 
$ 


To deal with the general case, consider this picture. 


CJ 

CIC] 
CJC) 
CICICICI 


Suppose we knew the area of the smaller, colored triangle. Then we could easily 
compute the area of the larger triangle as 


smallerArea + width 
How can we get the smaller area? Let’s make a smaller triangle and ask it! 


Triangle smallerTriangle = new Triangle(width - 1); 
int smallerArea = smallerTriangle.getAreaQ() ; 


Now we can complete the getArea method: 


public int getArea() 


{ 
if (width == 1) return 1; 
Triangle smallerTriangle = new Triangle(width - 1); 
int smallerArea = smallerTriangle.getArea() ; 
return smallerArea + width; 
} 


Here is an illustration of what happens when we compute the area of 
a triangle of width 4. 


¢ The getArea method makes a smaller triangle of width 3. 


¢ It calls getArea on that triangle. 


¢ That method makes a smaller triangle of width 2. 
* It calls getArea on that triangle. 
¢ That method makes a smaller triangle of width 1. 
¢ It calls getArea on that triangle. 
e That method returns 1. 
¢ The method returns smallerArea + width = 1 +2 =3. 
¢ The method returns smallerArea + width =3+3=6. 
¢ The method returns smallerArea + width =6+4= 10. 
This solution has one remarkable aspect. To solve the area problem for a triangle of 
a given width, we use the fact that we can solve the same problem for a lesser width. 
This is called a recursive solution. 
The call pattern of a recursive method looks complicated, and the key to the suc- 


cessful design of a recursive method is not to think about it. Instead, look at the 
getArea method one more time and notice how utterly reasonable it is. If the width 
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is 1, then, of course, the area is 1. The next part is just as reasonable. Compute the 
area of the smaller triangle and don’t think about why that works. Then the area 
of the larger triangle is clearly the sum of the smaller area and the width. 

There are two key requirements to make sure that the recursion is successful: 


e Every recursive call must simplify the computation in some way. 


e There must be special cases to handle the simplest computations directly. 


The getArea method calls itself again with smaller and smaller width 
values. Eventually the width must reach 1, and there is a special case 
for computing the area of a triangle with width 1. Thus, the getArea 
pasta method always succeeds. 

Keele you have to be careful. What happens when you call the area of a trian- 
gle with width -1? It computes the area of a triangle with width —2, which computes 
the area of a triangle with width -3, and so on. To avoid this, the getArea method 
should return 0 if the width is < 0. 

Recursion is not really necessary to compute the triangle numbers. The area of a 
triangle equals the sum 


1+2+4+3+.. . + width 
Of course, we can program a simple loop: 


double area = 0; 
for (int 71 = 1; i <= width; i++) 
area = area + 1; 


Many simple recursions can be computed as loops. However, loop equivalents for 
more complex recursions—such as the one in our next example—can be complex. 

Actually, in this case, you don’t even need a loop to compute the answer. The 
sum of the first 7 integers can be computed as 


1+2+--+n=nx(n+1)/2 


Thus, the area equals 
width * (width + 1) / 2 


Therefore neither recursion nor a loop is required to solve this problem. The recur- 
sive solution is intended as a “warm-up” to introduce you to the concept of recursion. 


ch13/triangle/Triangle.java 


l [** 

2 A triangular shape composed of stacked unit squares like this: 
3 C] ; 

4 CIC] 

5 CLICICI 

6 

7 */ 

8 public class Triangle 

2 f 
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10 [we 

11 Constructs a triangular shape. 

iz @param aWidth the width (and height) of the triangle 
13 * / 

14 public TriangleCint aWidth) 

15 { 

16 width = aWidth; 

17 } 

18 

19 [#e 

20 Computes the area of the triangle. 

21 @return the area 

22 * / 

23 public int getAreaQ) 

24 { 

25 if (width <= 9) return 0; 

26 if (width == 1) return 1; 

27 Triangle smallerTriangle = new Triangle(width - _); 
28 int smallerArea = smallerTriangle.getArea() ; 
29 return smallerArea + width; 

30 i 

31 

32 private int width; 

33} 


ch13/triangle/TriangleTester.java 


1 public class TriangleTester 
Zz 7% 
public static void main(String[] args) 
{ 
Triangle t = new Triangle(19); 
int area = t.getArea(); 
System.out.printInC'Area: " + area); 
System.out.printInC"Expected: 55"); 


OUoon anu hw 


jam 


} 


Output 


Enter width: 10 
Area: 55 
Expected: 55 


SELF CHECK 


1. Why is the statement if (width == 1) return 1; in the getArea method 
unnecessary? 
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2. How would you modify the program to recursively compute the area of a square? 
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COMMON ERROR 13.1 
Infinite Recursion 


A common programming error is an infinite recursion: a method calling itself over and over 
with no end in sight. The computer needs some amount of memory for bookkeeping for 
each call. After some number of calls, all memory that is available for this purpose is 
exhausted. Your program shuts down and reports a “stack fault”. 

Infinite recursion happens either because the parameter values don’t get simpler or 
because a special terminating case is missing. For example, suppose the getArea method com- 
putes the area of a triangle with width 0. If it wasn’t for the special test, the method would 
have constructed triangles with width -1, —2, -3, and so on. 


We will now turn to a more complex example of recursion that would be difficult to 
program with a simple loop. We will design a class that lists all permutations of a 
string. A permutation is simply a rearrangement of the letters. For example, the 
string "eat" has six permutations (including the original string itself): 


As in the preceding section, we will define a class that is in charge of computing the 
answer. In this case, the answer is not a single number but a collection of permuted 
strings. Here is our class: 


public class PermutationGenerator 


{ 
public PermutationGenerator(String aWord) { .. . } 
ArrayList<String> getPermutations() { .. . } 


} 


Here is the test program that prints out all permutations of the string "eat": 


ch13/permute/PermutationGeneratorDemo.java 


import java.util.ArrayList; 


This program demonstrates the permutation generator. 
* / 
public class PermutationGeneratorDemo 


{ 
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8 public static void main(String[] args) 
9 { 
10 PermutationGenerator generator 
Li = new PermutationGenerator("eat"); 
12 ArrayList<String> permutations = generator.getPermutations(); 
13 for (String s : permutations) 
14 { 
15 System.out.printIn(s); 
16 , 
17 } 
18 3} 
Output 
eat 
eta 
aet 
ate 
tea 
tae 


Now we need a way to generate the permutations recursively. Consider the string 
"eat". Let’s simplify the problem. First, we’ll generate all permutations that start 
with the letter 'e', then those that start with 'a', and finally those that start with 
't'. How do we generate the permutations that start with 'e'? We need to know 
the permutations of the substring "at". But that’s the same problem—to generate all 
permutations—with a simpler input, namely the shorter string "at". Thus, we can 
use recursion. Generate the permutations of the substring "at". They are 


nat” 
sole td 


For each permutation of that substring, prepend the letter 'e' to get the permuta- 
tions of "eat" that start with 'e', namely 


Now let’s turn our attention to the permutations of "eat" that start with 'a'. We 
need to produce the permutations of the remaining letters, "et". They are: 


et 
“tea” 


We add the letter 'a' to the front of the strings and obtain 


aet 
ate 


We generate the permutations that start with 't' in the same way. 
That’s the idea. The implementation is fairly straightforward. In the get- 
Permutations method, we loop through all positions in the word to be permuted. 
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For each of them, we compute the shorter word that is obtained by removing the 
ith letter: 


String shorterWord = word.substring(O, 1) + word.substring(i + 1); 


We construct a permutation generator to get the permutations of the shorter word, 
and ask it to give us all permutations of the shorter word. 


PermutationGenerator shorterPermutationGenerator 

= new PermutationGenerator(shorterWord) ; 
ArrayList<String> shorterWordPermutations 

= shorterPermutationGenerator.getPermutations() ; 


Finally, we add the removed letter to the front of all permutations of the shorter 
word. 


for (String s : shorterWordPermutations) 
{ 
} 


As always, we have to provide a special case for the simplest strings. The simplest 
possible string is the empty string, which has a single permutation — itself. 
Here is the complete PermutationGenerator class. 


result.add(word.charAt(i1) + S); 


ch13/permute/PermutationGenerator.java 


1 import java.util.ArrayList; 


2 
3 He 
4 This class generates permutations of a word. 
5 */ 
6 public class PermutationGenerator 
/ { 
8 [** 
9 Constructs a permutation generator. 
10 @param aWord the word to permute 
ll * / 
12 public PermutationGenerator(String aWord) 
13 { 
14 word = aWord; 
15 } 
16 
17 $e 
18 Gets all permutations of a given word. 
19 * / 
20 public ArrayList<String> getPermutations() 
21 { 
22 ArrayList<String> result = new ArrayList<String>(); 
23 
24 // The empty string has a single permutation: itself 
25 if (word.length() == 0) 
26 { 
27 result.add(word) ; 
28 return result; 
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30 

31 // Loop through all character positions 

32 for Cint i = 0; 7 < word.lengthQ; i++) 

33 if 

34 // Forma simpler word by removing the ith character 
35 String shorterWord = word.substring(0, 7) 

36 + word.substring(i + 1); 

37 

38 // Generate all permutations of the simpler word 

39 PermutationGenerator shorterPermutationGenerator 
40 = new PermutationGenerator(shorterWord) ; 
41 ArrayList<String> shorterWordPermutations 

42 = shorterPermutationGenerator.getPermutations(); 
43 

44 // Add the removed character to the front of 

45 // each permutation of the simpler word 

46 for (String s : shorterWordPermutations) 

47 { 

48 result.add(word.charAt(i) + s); 

49 } 

50 } 

51 // Return all permutations 

52 return result; 

53 } 

54 

55 private String word; 

56} 


Compare the PermutationGenerator and Triangle classes. Both of them work on the 
same principle. When they work on a more complex input, they first solve the 
problem for a simpler input. Then they combine the result for the simpler input 
with additional work to deliver the results for the more complex input. There really 
is no particular complexity behind that process as long as you think about the solu- 
tion on that level only. However, behind the scenes, the simpler input creates even 
simpler input, which creates yet another simplification, and so on, until one input is 
so simple that the result can be obtained without further help. It is interesting to 
think about this process, but it can also be confusing. What’s important is that you 
can focus on the one level that matters—putting a solution together from the 
slightly simpler problem, ignoring the fact that it also uses recursion to get its 
results. 


SELF CHECK 


3. What are all permutations of the four-letter word beat? 


4. Our recursion for the permutation generator stops at the empty string. What 
simple modification would make the recursion stop at strings of length 0 or 1? 
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COMMON ERROR 13.2 


Tracing Through Recursive Methods 


Debugging a recursive method can be somewhat challenging. When you set a breakpoint ina 
recursive method, the program stops as soon as that program line is encountered in any call 
to the recursive method. Suppose you want to debug the recursive getArea method of the 
Triangle class. Debug the TriangleTester program and run until the beginning of the 
getArea method. Inspect the width instance variable. It is 10. 

Remove the breakpoint and now run until the statement return smallerArea + width; 
(see Figure 1). When you inspect width again, its value is 2! That makes no sense. There was 
no instruction that changed the value of width. Is that a bug with the debugger? 

No. The program stopped in the first recursive call to getArea that reached the return 
statement. If you are confused, look at the call stack (top left in the figure). You will see that 
nine calls to getArea are pending. 

You can debug recursive methods with the debugger. You just need to be particularly 
careful, and watch the call stack to understand which nested call you currently are in. 


@ Debug - Triangle.java - Eclipse SDK 
File Edit Source Refactor Navigate Search Project Run Window Help 


pte br Or ae L 0 @ # | tae | POipe le Gr te a [Debug 
= 0 o variables 3 Breakpoints: z peas oO 
m%: FY _ Name “Value 


Triangle (id= 14) 
2 } 


(rreenp enc yavas-yopmewere 
v @ triangleTester at localhost:34951 


7 . Thread [main] (Suspended (breakpoint at line 29 in) § . . 
“’ smallertriangle Triangle (id= 20). 


pcg : & smallerArea 1 
= Triangle.getAreat} line: 28 


== Triangle.getArea( line: 28 
== Triangle.getArea() line: 28 
= Triangle.getAreat) line: 28 
= Triangle .getArea() line: 28 
= Triangle.get4rea() line: 28 
=: Triangle.getArea() line: 238 
= Triangle.getArea() line: 28 
= iahllanls nbd mang): line: 6 


D ae java xa 


Computes tha area of the triangle. 
f@return the area 


public int getArea() 
{ 
if (width <= 8} return 9; 
df (width == 1) return 1; 
Triangle smallerTriangle = new Triangle(width - 1); 


int smallerArea = smallerTriangle.getArea() ; 
‘turn smallerArea + width; 


@ console a Tasks | 
ee ava Application] fhomejappsyidk1. 6. Q- b104sbinjjava {Nov 30, 2006 2:13:52 PM} 


Figure 1 Debugging a Recursive Method 
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How To 13.1 


Thinking Recursively 


To solve a problem recursively requires a different mindset than to solve it by programming 
loops. In fact, it helps if you are, or pretend to be, a bit lazy and like others to do most of the 
work for you. If you need to solve a complex problem, pretend that “someone else” will do 
most of the heavy lifting and solve the problem for all simpler inputs. Then you only need to 
figure out how you can turn the solutions with simpler inputs into a solution for the whole 
problem. 

To illustrate the method of recursion, let us consider the following problem. We want to 
test whether a sentence 1s a palindrome —a string that is equal to itself when you reverse all 
characters. Typical examples of palindromes are 


e A man, a plan, a canal— Panama! 
¢ Go hang a salami, I’m a lasagna hog 


and, of course, the oldest palindrome of all: 
e¢ Madam, I’m Adam 


When testing for a palindrome, we match upper- and lowercase letters, and ignore all spaces 
and punctuation marks. 
We want to implement the isPalindrome method in the following class: 


public class Sentence 


Constructs a sentence. 

@param aText a string containing all characters of the sentence 
* / 
public Sentence(String aTlext) 
{ 


text = alext; 


Tests whether this sentence is a palindrome. 

@return true if this sentence is a palindrome, false otherwise 
ay 
public boolean isPalindrome() 


{ 


private String text; 


} 
Step 1. Consider various ways to simplify inputs. 


In your mind, fix a particular input or set of inputs for the problem that you want to solve. 
Think how you can simplify the inputs in such a way that the same problem can be 
applied to the simpler input. 
When you consider simpler inputs, you may want to remove just a little bit from the orig- 
inal input— maybe remove one or two characters from a string, or remove a small portion of 
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a geometric shape. But sometimes it is more useful to cut the input in half and then see what 
it means to solve the problem for both halves. 

In the palindrome test problem, the input is the string that we need to test. How can you 
simplify the input? Here are several possibilities: 


¢ Remove the first character. 

¢ Remove the last character. 

e Remove both the first and last characters. 
¢ Remove a character from the middle. 

e Cut the string into two halves. 


These simpler inputs are all potential inputs for the palindrome test. 
Step 2. Combine solutions with simpler inputs into a solution of the original problem. 


In your mind, consider the solutions of your problem for the simpler inputs that you discov- 
ered in Step 1. Don’t worry bow those solutions are obtained. Simply have faith that the 
solutions are readily available. Just say to yourself: These are simpler inputs, so someone else 
will solve the problem for me. 

Now think how you can turn the solution for the simpler inputs into a solution for the 
input that you are currently thinking about. Maybe you need to add a small quantity, related 
to the quantity that you lopped off to arrive at the simpler input. Maybe you cut the original 
input in half and have solutions for each half. Then you may need to add both solutions to 
arrive at a solution for the whole. 

Consider the methods for simplifying the inputs for the palindrome test. Cutting the 
string in half doesn’t seem a good idea. If you cut 


"Madam, I'm Adam" 

in half, you get two strings: 
"Madam, I" 

and 
"™m Adam" 


Neither of them is a palindrome. Cutting the input in half and testing whether the halves are 
palindromes seems a dead end. 

The most promising simplification is to remove the first avd last characters. 

Removing the M at the front and the mat the back yields 


"adam, I'm Ada" 


Suppose you can verify that the shorter string is a palindrome. Then of course the original 
string is a palindrome—we put the same letter in the front and the back. That’s extremely 
promising. A word is a palindrome if 


¢ The first and last letters match (ignoring letter case) 
and 
¢ The word obtained by removing the first and last letters is a palindrome. 


Again, don’t worry how the test works for the shorter string. It just works. 
There is one other case to consider. What if the first or last letter of the word is not a let- 
ter? For example, the string 


"A man, a plan, a canal, Panama!" 


13.2 s Permutations 599 


ends in a ! character, which does not match the A in the front. But we should ignore non- 
letters when testing for palindromes. Thus, when the last character is not a letter but the first 
character is a letter, it doesn’t make sense to remove both the first and the last characters. 
That’s not a problem. Remove only the last character. If the shorter string is a palindrome, 
then it stays a palindrome when you attach a nonletter. 

The same argument applies if the first character is not a letter. Now we have a complete 
set of cases. 


e Ifthe first and last characters are both letters, then check whether they match. If so, 
remove both and test the shorter string. 


e Otherwise, if the last character isn’t a letter, remove it and test the shorter string. 
e Otherwise, the first character isn’t a letter. Remove it and test the shorter string. 


In all three cases, you can use the solution to the simpler problem to arrive at a solution to 
your problem. 


Step 3. Find solutions to the simplest inputs. 


A recursive computation keeps simplifying its inputs. Eventually it arrives at very simple 
inputs. To make sure that the recursion comes to a stop, you must deal with the simplest 
inputs separately. Come up with special solutions for them, which is usually very easy. 

However, sometimes you get into philosophical questions dealing with degenerate 1 inputs: 
empty strings, shapes with no area, and so on. Then you may want to investigate a slightly 
larger input that gets reduced to such a trivial input and see what value you should attach to 
the degenerate inputs so that the simpler value, when used according to the rules you discov- 
ered in Step 2, yields the correct answer. 

Let’s look at the simplest strings for the palindrome test: 


® Strings with two characters 
e Strings with a single character 
¢ The empty string 


We don’t have to come up with a special solution for strings with two characters. Step 2 still 
applies to those strings—either or both of the characters are removed. But we do need to 
worry about strings of length 0 and 1. In those cases, Step 2 can’t apply. There aren’t two 
characters to remove. 

The empty string is a palindrome—it’s the same string when you read it backwards. If 
you find that too artificial, consider a string "mm". According to the rule discovered in Step 2, 
this string is a palindrome if the first and last characters of that string match and the 
remainder —that is, the empty string —is also a palindrome. Therefore, it makes sense to con- 
sider the empty string a palindrome. 

A string with a single letter, such as "I", is a palindrome. How about the case in which the 
character is not a letter, such as "!"? Removing the ! yields the empty string, which is a pal- 
indrome. Thus, we conclude that all strings of length 0 or 1 are palindromes. 


Step 4 Implement the solution by combining the simple cases and the reduction step. 


Now you are ready to implement the solution. Make separate cases for the simple inputs that 
you considered in Step 3. If the input isn’t one of the simplest cases, then implement the logic 
you discovered in Step 2. 

Here is the isPalindrome method. 


public boolean isPalindrome() 


{ 
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int length = text. length(); 


// Separate case for shortest strings. 
if (length <= 1) return true; 


// Get first and last characters, converted to lowercase. 
char first = Character.toLowerCase(text.charAt(0)); 


char last = Character.toLowerCase(text.charAtClength - 1)); 


if (Character.isLetter(first) && Character.isLetter(Clast)) 


{ 
// Both are letters. 
if {first == last) 
{ 
// Remove both first and last character. 
Sentence shorter = new Sentence(text.substring(1, length - 1)); 
return shorter.isPalindrome() ; 
} 
else 
return false; 
} 
else if (!Character.isLetter(last)) 
{ 
// Remove last character. 
Sentence shorter = new Sentence(text.substring(O, length - 1)); 
return shorter.isPalindrome() ; 
} 
else 
{ 


// Remove first character. 
Sentence shorter = new Sentence(text.substring(1)) ; 
return shorter.isPalindrome() ; 


Sometimes it is easier to find a recursive solution if you change the 
original problem slightly. Then the original problem can be solved by 
calling a recursive helper method. 

Here is a typical example. Consider the palindrome test of How 
To 13.1. It is a bit inefficient to construct new Sentence objects in 
every step. Now consider the following change in the problem. 
Rather than testing whether the entire sentence is a palindrome, let’s check whether 
a substring is a palindrome: 
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Tests whether a substring of the sentence is a palindrome. 
@param start the index of the first character of the substring 
@param end the index of the last character of the substring 
@return true if the substring is a palindrome 

* / 


public boolean isPalindrome(int start, int end) 


This method turns out to be even easier to implement than the original test. In the 
recursive calls, simply adjust the start and end parameters to skip over matching 
letter pairs and characters that are not letters. There is no need to construct new 
Sentence objects to represent the shorter strings. 


public boolean 1sPalindrome(int start, int end) 
{ 

// Separate case for substrings of length 0 and 1. 

if (start >= end) return true; 


// Get first and last characters, converted to lowercase. 
char first = Character.toLowerCase(text.charAt(start)); 
char last = Character.toLowerCase(text.charAt(end) ); 


if CCharacter.isLetter(first) && Character.isLetter(last)) 


{ 
if (first == last) 


// Test substring that doesn’t contain the matching letters. 
return isPalindrome(start + 1, end - 1); 
} 
else 
return false; 
} 
else if (!Character.isLetter(last)) 


// Test substring that doesn’t contain the last character. 
return isPalindrome(start, end - 1); 


} 

else 
// est substring that doesn’t contain the first character. 
return isPalindrome(start + 1, end); 

} 


} 


You should still supply a method to solve the whole problem—the user of your 
method shouldn’t have to know about the trick with the substring positions. Sim- 
ply call the helper method with positions that test the entire string: 


public boolean 1sPalindrome() 
{ 
| 


Note that this call is not a recursive method. The isPalindrome() method calls the 
helper method isPalindrome(int, int). In this example, we use overloading to 
define two methods with the same name. The isPalindrome method without 


return 1sPalindrome(O, text.lengthQ - 1); 
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parameters is the method that we expect the public to use. The second method, with 
two int parameters, is the recursive helper method. If you prefer, you can avoid 
overloaded methods by choosing a different name for the helper method, such as 
substringlsPalindrome. 

Use the technique of recursive helper methods whenever it is easier to solve a 
recursive problem that is slightly different from the original problem. 


SELF CHECK 


5. Do we have to give the same name to both isPalindrome methods? 


6. When does the recursive isPalindrome method stop calling itself? 


As you have seen in this chapter, recursion can be a powerful tool to implement 
complex algorithms. On the other hand, recursion can lead to algorithms that per- 
form poorly. In this section, we will analyze the question of when recursion is ben- 
eficial and when it is inefficient. 

Consider the Fibonacci sequence introduced in Exercise P6.4: a sequence of 
numbers defined by the equation 


f,=1 
fy, =1 
Le ty 


That is, each value of the sequence is the sum of the two preceding values. The first 
ten terms of the sequence are 


1 dg 2p 0405 1p Zl ts OD 


It is easy to extend this sequence indefinitely. Just keep appending the sum of the 
last two values of the sequence. For example, the next entry is 34 + 55 = 89. 

We would like to write a function that computes f, for any value of 7. Let us 
translate the definition directly into a recursive method: 


ch13/fib/RecursiveFib.java 


1 import java.util.Scanner; 

2 

3 [xe 

4 This program computes Fibonacci numbers using a recursive 
; method. 


ale 
n 
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7 public class RecursiveFib 


8 { 
9 public static void main(String[] args) 
10 { 
11 Scanner in = new Scanner(System.in); 
12 System.out.print("Enter n: "); 
13 int n = in.nextInt(); 
14 
15 for (int i = 1; i <= n; i++) 
16 { 
17 long f = fib(i); 
18 System.out.printin("fib(" + 14+ ") =" + f); 
19 } 
20 } 
21 
22 co 
Pe Computes a Fibonacci number. 
24 @param n an integer 
25 @return the nth Fibonacci number 
26 ad 
rz 4 public static long fibCint n) 
28 { 
29 if (n <= 2) return 1; 
30 else return fib(n - 1) + fib(n - 2); 
31 } 
32 } 
Output 
Enter n: 50 
FfibC(1) = 1 
fib(2) = 1 
fib(3) = 2 
fib(4) = 3 
fib(S) = 5 
fib(6) = 8 
fib(7) = 13 


fib(€50) = 12586269025 


That is certainly simple, and the method will work correctly. But watch the output 
closely as you run the test program. The first few calls to the fib method are quite 
fast. For larger values, though, the program pauses an amazingly long time between 
outputs. 

That makes no sense. Armed with pencil, paper, and a pocket calculator you 
could calculate these numbers pretty quickly, so it shouldn’t take the computer any- 
where near that long. 

To find out the problem, let us insert trace messages into the method: 
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ch13/fib/RecursiveFibTracer.java 


1 import java.util.Scanner; 


2 

3 WO 

4 This program prints trace messages that show how often the 

: recursive method for computing Fibonacci numbers calls itself. 

‘ public class RecursiveFibTracer 

{ 
tr public static void main(String[] args) 
{ 

ll Scanner in = new Scanner(System.in); 

12 System.out.print("Enter n: "); 

13 int n = in.nextInt(): 
14 
15 long f = fib(n); 

16 

17 System.out.printin("fibC" + n+") =" + f); 
18 } 

19 
20 ies 
21 Computes a Mibonacet number. 
22 @param n an integer 
23 @return the wth Fibonacci number 
24 */ 
25 public static long fibCint n) 
26 { 
27 System.out.printIn("Entering fib: n = "4+ n); 
28 long f; 
29 if (n <= 2) f = 1; 
30 else f = fib(n - 1) + fib(n - 2); 
31 System.out.printin("Exiting fib: n=" 4n 
32 + " return value = " + f); 
33 return f; 
34 
35} 
Output 

Enter n: 6 


Entering fib: 
Entering fib: 
Entering fib: 
Entering fib: 
Entering fib: 7 
Exiting fib: n = 2 return value = 1 
Entering fib: n= 1 

Exiting fib: n = 1 return value = 1 
Exiting fib: n = 3 return value = 2 
Entering fib: n = 2 

Exiting fib: n = 2 return value = 1 
Exiting fib: n = 4 return value = 


oe ee ee ee) 
| 
NW ARUN D 


WW 
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Entering fib: n = 3 

Entering fib: n = 2 

Exiting fib: n = 2 return value = 1 
Entering fib: n = 1 

Exiting fib: n = 1 return value = 1 
Exiting fib: n = 3 return value = 2 
Exiting fib: n = 5 return value = 5 
Entering fib: n = 4 

Entering fib: n = 3 

Entering fib: n = 2 

Exiting fib: n = 2 return value = 1 
Entering fib: n= 1 

Exiting fib: n = 1 return value = 1 
Exiting fib: n = 3 return value = 2 
Entering fib: n = 2 

Exiting fib: n = 2 return value = 1 
Exiting fib: n = 4 return value = 3 
Exiting fib: n = 6 return value = 8 
fib(6) = 8 
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Figure 2 shows the call tree for computing fib(6). Now it is becoming apparent 
why the method takes so long. It is computing the same values over and over. For 
example, the computation of fib(6) calls fib(4) twice and fib(3) three times. That 
is very different from the computation we would do with pencil and paper. There 
we would just write down the values as they were computed and add up the last 
two to get the next one until we reached the desired entry; no sequence value would 


ever be computed twice. 


If we imitate the pencil-and-paper process, then we get the following program. 


FibC6) 


FibC5) FibC4) 


Fib(4) Fib(3) Fib(3) 


fib(3) fib(2) fib(2) fib(1) fib(2) fib(1) 


fib(2) fibC1) 


Figure 2 Call Pattern of the Recursive fib Method 
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ch13/fib/LoopFib.java 


1 import java.util.Scanner; 
2 
>» fre 
4 This program computes Fibonacci numbers using an iterative method. 
5 * 
6 public class LoopFib 
7 { 
8 public static void main(String[] args) 
9 { 
10 Scanner in = new Scanner(System.in); 
11 System.out.print("Enter n: "); 
12 int n = in.nextIntQ); 
13 
14 for Cint i = 1; i <= n; i++) 
15 { 
16 long f = fibCi); 
17 System.out.printInC"fibcC" + 1+") =" + f); 
18 } 
19 } 
20 
21 [** 
22 Computes a Fibonacci number. 
Pa @param n an integer 
24 @Greturn the nth Fibonacci number 
25 */ 
26 public static long fibCint n) 
27 { 
28 if (n <= 2) return 1: 
29 long fold = 1; 
30 long fold2 = 1; 
31 long fnew = 1; 
32 for Cint i = 3; i <= n: i++) 
33 { 
34 fnew = fold + fold2; 
35 fold2 = fold; 
36 fold = fnew; 
37 } 
38 return fnew; 
39 } 
40 } 
Output 
Enter n: 50 
fib(1l) = 1 
fib(2) = 1 
fibC3) = 2 
fib(4) = 3 
fibC5) = 5 
fib(6) = 8 
fib(7) = 13 


Fib(50) = 12586269025 
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This method runs much faster than the recursive version. 

In this example of the fib method, the recursive solution was easy to program 
because it exactly followed the mathematical definition, but it ran far more slowly 
than the iterative solution, because it computed many intermediate results multiple 
times. 

Can you always speed up a recursive solution by changing it into a loop? Fre- 
quently, the iterative and recursive solution have essentially the same performance. 
For example, here is an iterative solution for the palindrome test. 


public boolean isPalindrome() 
{ 
int start = 0; 
int end = text.length(Q) - 1; 
while (start < end) 
{ 
char first = Character.toLowerCase(text.charAt(start)) ; 
char last = Character.toLowerCase(text.charAt(end) ; 


if (Character.isLetter(first) && Character.isLetter(last)) 


// Both are letters. 
if (first == last) 
i 

Start++; 

end--; 
} 
else 

return false; 


if (!Character.isLetter(last)) 
end--; 

if (!Character.isLetter(first)) 
Sstart++; 


} 


return true; 


} 


This solution keeps two index variables: start and end. The first index starts at the 
beginning of the string and is advanced whenever a letter has been matched or a 
nonletter has been ignored. The second index starts at the end of the string and 
moves toward the beginning. When the two index variables meet, the iteration stops. 

Both the iteration and the recursion run at about the same speed. 
If a palindrome has » characters, the iteration executes the loop 
between n/2 and n times, depending on how many of the characters 
are letters, since one or both index variables are moved in each step. 
Similarly, the recursive solution calls itself between 7/2 and n umes, 
because one or two characters are removed in each step. 

In such a situation, the iterative solution tends to be a bit faster, 
because each recursive method call takes a certain amount of proces- 
sor time. In principle, it is possible for a smart compiler to avoid recursive method 
calls if they follow simple patterns, but most compilers don’t do that. From that 
point of view, an iterative solution is preferable. 
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There are quite a few problems that are dramatically easier to solve recursively 
than iteratively. For example, it is not at all obvious how you can come up with a 
nonrecursive solution for the permutation generator. As Exercise P13.11 shows, it is 
possible to avoid the recursion, but the resulting solution is quite complex (and no 
faster). 

Often, recursive solutions are easier to understand and implement 


_Inmany cases, arecursive correctly than their iterative counterparts. There is a certain elegance 


‘solution is easierto 
understand and implement 


correctly than an iter 
‘solution. , 


and economy of thought to recursive solutions that makes them 
more appealing. As the computer scientist (and creator of the Ghost- 
Script interpreter for the PostScript graphics description language) L. 
Peter Deutsch put it: “To iterate is human, to recurse divine.” 


SELF CHECK 


7. You can compute the factorial function either with a loop, using the definition 
that m! =1x2x...x~x, or recursively, using the definition that 0! = 1 and 
n! =(n-1)! xn. Is the recursive approach inefficient in this case? 


8. Why isn’t it easy to develop an iterative solution for the permutation generator? 


RANDOM FACT 13.1 


The Limits of Computation 


Have you ever wondered how your instructor or grader makes sure your programming 
homework is correct? In all likelihood, they look at your solution and perhaps run it with 
some test inputs. But usually they have a correct solution available. That suggests that there 
might be an easier way. Perhaps they could feed your program and their correct program 
into a “program comparator”, a computer program that analyzes both programs and deter- 
mines whether they both compute the same results. Of course, your solution and the pro- 
gram that is known to be correct need not be identical—what matters is that they produce 
the same output when given the same input. 

How could such a program comparator work? Well, the Java compiler knows how to 
read a program and make sense of the classes, methods, and statements. So it seems plausible 
that someone could, with some effort, write a program that reads two Java programs, ana- 
lyzes what they do, and determines whether they solve the same task. Of course, such a pro- 
gram would be very attractive to instructors, because it could automate the grading process. 
Thus, even though no such program exists today, it might be tempting to try to develop one 
and sell it to universities around the world. 

However, before you start raising venture capital for such an effort, you should know 
that theoretical computer scientists have proven that it is impossible to develop such a pro- 
gram, no matter how hard you try. 

There are quite a few of these unsolvable problems. The first one, called the halting prob- 
lem, was discovered by the British researcher Alan Turing in 1936 (see photo below). 
Because his research occurred before the first actual computer was constructed, Turing had 
to devise a theoretical device, the Turing machine, to explain how computers could work. 
The Turing machine consists of a long magnetic tape, a read/write head, and a program that 
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Alan Turing 


has numbered instructions of the form: “If the current symbol under the head is x, then 
replace it with y, move the head one unit left or right, and continue with instruction n” (see A 
Turing Machine). Interestingly enough, with only these instructions, you can program just as 
much as with Java, even though it is incredibly tedious to do so. Theoretical computer scien- 
tists like Turing machines because they can be described using nothing more than the laws of 
mathematics. 


Program 


right 


1 0 2 2 
1 1 1 left 4 
2 0 0 right 2 
2 1 1 right 2 
y 2 0 left 3 
3 0 0 left 3 
3 1 1 left 3 
3 2 2 right 1 
4 1 1 right 5 
4 2 0 left 4 


Read/write head 


Tape 


A Turing Machine 
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Expressed in terms of Java, the halting problem states: “It is impossible to write a pro- 
gram with two inputs, namely the source code of an arbitrary Java program P and a string J, 
and that decides whether the program P, when executed with the input J, will halt without 
getting into an infinite loop”. Of course, for some kinds of programs and inputs, it is possi- 
ble to decide whether the program halts with the given input. The halting problem asserts 
that it is impossible to come up with a single decision-making algorithm that works with all 
programs and inputs. Note that you can’t simply run the program P on the input J to settle 
this question. If the program runs for 1,000 days, you don’t know that the program is in an 
infinite loop. Maybe you just have to wait another day for it to stop. 

Such a “halt checker”, if it could be written, might also be useful for grading homework. 
An instructor could use it to screen student submissions to see if they get into an infinite 
loop with a particular input, and then stop checking them. However, as Turing demon- 
strated, such a program cannot be written. His argument is ingenious and quite simple. 

Suppose a “halt checker” program existed. Let’s call it H. From H, we will develop 
another program, the “killer” program K. K does the following computation. Its input is a 
string containing the source code for a program R. It then applies the halt checker on the 
input program R and the input string R. That is, it checks whether the program R halts if its 
input is its own source code. It sounds bizarre to feed a program to itself, but it isn’t impos- 
sible. For example, the Java compiler is written in Java, and you can use it to compile itself. 
Or, as a simpler example, a word counting program can count the words in its own source 
code. 

When K gets the answer from H that R halts when applied to itself, it is programmed to 
enter an infinite loop. Otherwise K exits. In Java, the program might look like this: 


public class Killer 


{ 
public static void main(String[] args) 
{ 
String r = read program input; 
HaltChecker checker = new HaltChecker(); 
if Cchecker.check(r, r)) 
while (true) { } // Infinite loop 
else 
return; 
$ 
5 


Now ask yourself: What does the halt checker answer when asked whether K halts when 
given K as the input? Maybe it finds out that K gets into an infinite loop with such an input. 
But wait, that can’t be right. That would mean that checker. check(r, r) returns false when 
ris the program code of K. As you can plainly see, in that case, the killer method returns, 
so K didn’t get into an infinite loop. That shows that K must halt when analyzing itself, so 
checker.check(r, r) should return true. But then the killer method doesn’t terminate—it 
goes into an infinite loop. That shows that it is logically impossible to implement a program 
that can check whether every program halts on a particular input. 

It is sobering to know that there are mits to computing. There are problems that no 
computer program, no matter how ingenious, can answer. 

Theoretical computer scientists are working on other research involving the nature of 
computation. One important question that remains unsettled to this day deals with problems 
that in practice are very time-consuming to solve. It may be that these problems are intrinsi- 
cally hard, in which case it would be pointless to try to look for better algorithms. Such the- 
oretical research can have important practical applications. For example, right now, nobody 
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knows whether the most common encryption schemes used today could be broken by dis- 
covering a new algorithm (see Random Fact 19.1 for more information on encryption algo- 
rithms). Knowing that no fast algorithms exist for breaking a particular code could make us 
feel more comfortable about the security of encryption. 


In the preceding examples, a method called itself to solve a simpler 
problem. Sometimes, a set of cooperating methods calls each other in 
a recursive fashion. In this section, we will explore a typical situation 
of such a mutual recursion. This technique is significantly more 
advanced than the simple recursion that we discussed in the preceding 
sections. Feel free to skip this section if this is your first exposure to recursion. 

We will develop a program that can compute the values of arithmetic expressions 
such as 

3445 

(3+4)*5 

dete (3-44-3392 
Computing such an expression is complicated by the fact that * and / bind more 
strongly than + and -, and that parentheses can be used to group subexpressions. 

Figure 3 shows a set of syntax diagrams that describes the syntax of these expres- 
sions. To see how the syntax diagrams work, consider the expression 3+4*5. When 


expression = oS term 
oa 
term factor 
. 
( expression =) 
factor 


Figure 3 Syntax Diagrams for Evaluating an Expression 
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you enter the expression syntax diagram, the arrow points directly to term, giving 
you no alternative but to enter the term syntax diagram. The arrow points to factor, 
again giving you no choice. You enter the factor diagram, and now you have two 
choices: to follow the top branch or the bottom branch. Because the first input 
token is the number 3 and not a (, you must follow the bottom branch. You accept 
the input token because it matches the number. Follow the arrow out of number to 
the end of factor. Just like in a method call, you now back up, returning to the end 
of the factor element of the term diagram. Now you have another choice—to loop 
back in the term diagram, or to exit. The next input token is a +, and it matches nei- 
ther the * or the / that would be required to loop back. So you exit, returning to 
expression. Again, you have a choice, to loop back or to exit. Now the + matches 
one of the choices in the loop. Accept the + in the input and move back to the term 
element. 

In this fashion, an expression is broken down into a sequence of terms, separated 
by + or -, each term is broken down into a sequence of factors, each separated by * 
or /, and each factor is either a parenthesized expression or a number. You can draw 
this breakdown as a tree. Figure 4 shows how the expressions 3+4*5 and (3+4)*5 are 
derived from the syntax diagram. 

Why do the syntax diagrams help us compute the value of the tree? If you look at 
the syntax trees, you will see that they accurately represent which operations 
should be carried out first. In the first tree, 4 and 5 should be multiplied, and then 
the result should be added to 3. In the second tree, 3 and 4 should be added, and the 
result should be multiplied by 5. 

At the end of this section, you will find the implementation of the Evaluator 
class, which evaluates these expressions. The Evaluator makes use of an Expression- 
Tokenizer class, which breaks up an input string into tokens—numbers, operators, 
and parentheses. (For simplicity, we only accept positive integers as numbers, and 
we don’t allow spaces in the input.) 


Expression 
Term 
Factor Factor 
Expression Expression Number 
Term Term Term Term 
Factor Factor Factor Pactor Factor 
Number Number Number Number Number 
3 + 4 * 5 ( 3 + 4 ) * 5 


Figure 4 Syntax Trees for Two Expressions 


13.5 ® Mutual Recursions 613 


When you call nextToken, the next input token is returned as a string. We also 
supply another method, peekToken, which allows you to see the next token without 
consuming it. To see why the peekToken method is necessary, consider the syntax 
diagram of the factor type. If the next token is a'"*" or "/", you want to continue 
adding and subtracting terms. But if the next token is another character, such as a 
"4" or "=", you want to stop without actually consuming it, so that the token can be 
considered later. 

To compute the value of an expression, we implement three methods: get- 
ExpressionValue, getTermValue, and getFactorValue. The getExpressionValue 
method first calls getTermValue to get the value of the first term of the expression. 
Then it checks whether the next input token is one of + or -. If so, it calls getTerm- 
Value again and adds or subtracts it. 


public int getExpressionValue() 


{ 
int value = getTermValue(); 
boolean done = false; 
while (!done) 
{ 
String next = tokenizer.peekToken() ; 
if ("+".equals(next) || "-".equals(next)) 
{ 
tokenizer.nextToken(); // Discard "+" or "-" 
int value2 = getTermValue(); 
if ("+".equals(next)) value = value + value2; 
else value = value - value2; 
} 
else done = true; 
} 
return value; 
} 


The getTermValue method calls getFactorValue in the same way, multiplying or 
dividing the factor values. 

Finally, the getFactorValue method checks whether the next input is a number, or 
whether it begins with a ¢ token. In the first case, the value is simply the value of the 
number. However, in the second case, the getFactorValue method makes a recursive 
call to getExpressionValue. Thus, the three methods are mutually recursive. 


public int getFactorValue() 

{ 
int value; 
String next = tokenizer.peekToken() ; 
if C"C'.equals (next) ) 


{ 
tokenizer.nextToken(); // Discard "(" 
value = getExpressionValue() ; 
tokenizer.nextToken(); // Discard '")" 

} 

else 


value = Integer.parseInt(tokenizer.nextToken()); 
return value; 
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To see the mutual recursion clearly, trace through the expression (3+4)*5: 


® getExpressionValue calls getTermValue 
® getTermValue calls getFactorValue 
® getFactorValue consumes the ( input 
® getFactorValue calls getExpressionValue 


® getExpressionValue returns eventually with the value of ta 
having consumed 3 + 4. This is the recursive call. 


® getFactorValue consumes the ) input 
® getFactorValue returns 7 
® getTermValue consumes the inputs * and 5 and returns 35 
® getExpressionValue returns 35 
As always with a recursive solution, you need to ensure that the recursion termi- 
nates. In this situation, that is easy to see. If getExpressionValue calls itself, the sec- 
ond call works on a shorter subexpression than the original expression. At each 


recursive call, at least some of the tokens of the input string are consumed, so even- 
tually the recursion must come to an end. 


ch13/expr/Evaluator.java 


l 
2 A class that can compute the value of an arithmetic expression. 
3 + 
4 public class Evaluator 
5 { 
6 ead 
7 Constructs an evaluator. 
8 @param anExpression a string containing the expression 
9 to be evaluated 
10 * / 
11 public Evaluator(String anExpression) 
12 { 
13 tokenizer = new ExpressionTokenizer(anExpression) ; 
14 } 
15 
16 so 
17 Evaluates the expression. 
18 @return the value of the expression 
19 * 
20 public int getExpressionValue() 
21 f 
Ze int value = getTermValue(); 
23 boolean done = false; 
24 while (!done) 
25 f 
26 String next = tokenizer.peekToken(): 
ray j if ("+".equals(next) || "-'".equals(next)) 


28 


{ 


Mutual Recursions 


i Ri 


tokenizer.nextToken(); // Discard "+" or 
int value2 = getTermValue() ; 

if ('+''.equals(next)) value = value + value2; 
else value = value - value2; 


else done = true; 


} 


return value; 


Evaluates the next term found in the expression. 
@return the value of the term 


public int getTermValue() 


int value = getFactorValue() ; 
boolean done = false; 
while (C!done) 


{ 
String next = tokenizer.peekToken() ; 
if C'*".equals(next) || "/".equals(next)) 
1 
tokenizer.nextTokenQ ; 
int value2 = getFactorValue() ; 
if ('*'".equals(next)) value = value * value2; 
else value = value / value2; 
} 
else done = true; 
} 


return value; 


Evaluates the next factor found in the expression. 


@return the value of the factor 


public int getFactorValue() 


{ 


} 


int value; 
String next = tokenizer.peekToken() ; 
if C'C'.equals(Cnext) ) 


{ 
tokenizer.nextToken(); // Discard "C" 
value = getExpressionValue() ; 
tokenizer.nextToken(); // Discard ")" 

} 

else 


value = Integer.parseInt(tokenizer.nextTokenQ) ; 
return value; 


private ExpressionTokenizer tokenizer; 
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ch13/expr/ExpressionTokenizer.java 


Ho al 
wR 


This class breaks up a string describing an expression 
into tokens: numbers, parentheses, and operators. 


* / 
public class ExpressionTokenizer 
{ 
[ee 
Constructs a tokenizer. 
@param anInput the string to tokenize 


2 

3 

4 

5 

6 

7 

8 

9 
10 * / 
i: public ExpressionTokenizer(String anInput) 
13 
14 


: 
input = anInput; 
start = ©; 

15 end = ©; 
16 nextToken(); 
17 } 
18 
19 / * 
20 Peeks at the next token without consuming it. 
21 @return the next token or nu11 if there are no more tokens 
re * / 
23 public String peekToken() 
24 { 
25 if (start >= input.length()) return null; 
26 else return input.substring(start, end); 
27 } 
28 
29 we 
30 Gets the next token and moves the tokenizer to the following token. 
31 @return the next token or nul1 if there are no more tokens 
32 */ 
33 public String nextToken() 
34 f 
35 String r = peekToken(); 
36 start = end; 
37 if (start >= input.Jength()) return r; 
38 if (Character.isDigit(input.charAt(start))) 
39 { 
40 end = start + -; 
41 while (end < input. length() 
42 && Character.isDigit(input.charAt(end))) 
43 end++; 
44 } 
45 else 
46 end = start +=; 
47 return r; 
48 } 
49 
50 private String input; 
SL private int start; 
52 private int end: 
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ch13/expr/ExpressionCalculatorjava 


1 import java.util.Scanner; 
2 
3 - 4 * 
4 This program calculates the value of an expression | 
5 consisting of numbers, arithmetic operators, and parentheses. 
6 */ 
7 public class ExpressionCalculator 
8 { 
9 public static void main(String[] args) 
10 { 
ll Scanner in = new Scanner(System. in) ; 
12 System.out.printC"Enter an expression: "); 
13 String input = in.nextLine(); 
14 Evaluator e = new Evaluator(input) ; 
15 int value = e.getExpressionValue() ; 
16 System.out.printInCinput + "=" + value); 
17 } 
18 3} 
Output 
Enter an expression: 3+4*5 
34+4*5=23 
SELF CHECK 


9. What is the difference between a term and a factor? Why do we need both 
concepts? 


10. Why does the expression parser use mutual recursion? 


11, What happens if you try to parse the illegal expression 3+4*)5? Specifically, 
which method throws an exception? 


CHAPTER SUMMARY 


1. A recursive computation solves a problem by using the solution of the same 
problem with simpler values. 


2. For a recursion to terminate, there must be special cases for the simplest values. 


3. Sometimes it is easier to find a recursive solution if you make a slight change to 
the original problem. 


4. Occasionally, a recursive solution runs much slower than its iteratrve counter- 
part. However, in most cases, the recursive solution is only slightly slower. 


5. In many cases, a recursive solution is easier to understand and implement 
correctly than an iterative solution. 


6. Ina mutual recursion, a set of cooperating methods calls each other repeatedly. 
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REVIEW EXERCISES = 


Exercise R13.1. Define the terms 
a. Recursion 
b. Iteration 
c. Infinite recursion 


d. Recursive helper method 


Exercise R13.2. Outline, but do not implement, a recursive solution for finding the 
smallest value in an array. 


Exercise R13.3. Outline, but do not implement, a recursive solution for sorting an 
array of numbers. Hint: First find the smallest value in the array. 


Exercise R13.4. Outline, but do not implement, a recursive solution for generating all 
subsets of the set {1, 2,..., 7}. 


Exercise R13.5. Exercise P13.12 shows an iterative way of generating all permuta- 
tions of the sequence (0, 1,..., 2 — 1). Explain why the algorithm produces the 
correct result. 


Exercise R13.6. Write a recursive definition of x”, where 7 > 0, similar to the 
recursive definition of the Fibonacci numbers. Hint: How do you compute x” 
from x”~/? How does the recursion terminate? 

Exercise R13.7. Improve upon Exercise R13.6 by computing x” as (x)? if n is even. 
Why is this approach significantly faster? (Hint: Compute x!°*? and x!974 both 
ways.) 


Exercise R13.8. Write a recursive definition of m! = 1 x2 x...xv, similar to the 
recursive definition of the Fibonacci numbers. 


Exercise R13.9. Find out how often the recursive version of fib calls itself. Keep a 
static variable fibCount and increment it once in every call of fib. What is the rela- 
tionship between fib(n) and fibCount? 


Exercise R13.10. How many moves are required in the “Towers of Hanoi” problem 
of Exercise P13.13 to move n disks? Hint: As explained in the exercise, 


moves(1) = 1 


moves(7) = 2 - moves(z — 1) + 1 


Additional review exercises are available in WileyPLUS. 
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Exercise P13.1. Write a recursive method void reverse() that reverses a sentence. 
For example: 

Sentence greeting = new Sentence("Hello!"); 

greeting.reverse(); 

System.out.printIn(greeting.getText()); 
prints the string "!o11eH". Implement a recursive solution by removing the first 
character, reversing a sentence consisting of the remaining text, and combining the 
two. 


Exercise P13.2. Redo Exercise P13.1 with a recursive helper method that reverses a 
substring of the message text. 


Exercise P13.3. Implement the reverse method of Exercise P13.1 as an iteration. 


Exercise P13.4. Use recursion to implement a method boolean find(String t) that 
tests whether a string is contained in a sentence: 

Sentence s = new Sentence("Mississippi!"); 

boolean b = s.find("sip"); // Returns true 


Hint: If the text starts with the string you want to match, then you are done. If not, 
consider the sentence that you obtain by removing the first character. 


Exercise P13.5. Use recursion to implement a method int indexOf(String t) that 
returns the starting position of the first substring of the text that matches t. Return 
—1 if t is not a substring of s. For example, 

Sentence s = new Sentence("Mississippi!"); 

int n = s.indexOf("sip"); // Returns 6 
Hint: This is a bit trickier than the preceding problem, because you must keep 
track of how far the match is from the beginning of the sentence. Make that value a 
parameter of a helper method. 


Exercise P13.6. Using recursion, find the largest element in an array. 


public class DataSet 
{ 


public DataSet(int[] values, int first, int last) {.. . } 
public int getMaximum() { . . . } 
} 
Hint: Find the largest element in the subset containing all but the last element. Then 
compare that maximum to the value of the last element. 
Exercise P13.7. Using recursion, compute the sum of all values in an array. 


public class DataSet 
{ 
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public DataSetCint[] values, int first, int last) { ... } 
public int getSum(Q) { ... } 


} 


wx Exercise P13.8, Using recursion, compute the area of a polygon. Cut off a triangle 


kok 


kak 


took 


and use the fact that a triangle with corners (x1, y1)5 (X95 9/2)5 (x35 7/3) has area 


X41 Vo FXQV3 + XZ — WyXQ — YoXz — 5%; 
2 


Exercise P13.9. Implement a SubstringGenerator that generates all substrings of a 
string. For example, the substrings of the string "rum" are the seven strings 


r-, “ru, “rum, “u", “om, "ms 


FAiint: First enumerate all substrings that start with the first character. There are n of 
them if the string has length 7. Then enumerate the substrings of the string that you 
obtain by removing the first character. 


Exercise P13.10. Implement a SubsetGenerator that generates all subsets of the char- 
acters of a string. For example, the subsets of the characters of the string "rum" are 
the eight strings 


fun’, “re’, “ea, Me", "on", “o's. “mi 
Note that the subsets don’t have to be substrings—for example, "rm" isn’t a sub- 
string of "rum". 


Exercise P13.11. In this exercise, you will change the PermutationGenerator of Section 
13.2 (which computed all permutations at once) to a PermutationIterator (which 
computes them one at a time.) 


public class PermutationIterator 


{ 
public PermutationIterator(String s) {.. . } 
public String nextPermutation() { .. . } 
public boolean hasMorePernutations®) a «© w SF 
} 


Here is how you would print out all permutations of the string "eat": 


PermutationIterator iter = new PermutationIterator("eat"); 
while Citer.hasMorePermutations()) 
System.out.printIn(iter.nextPermutation()); 
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Now we need a way to iterate through the permutations recursively. Consider the 
string "eat". As before, we’ll generate all permutations that start with the letter 'e', 
then those that start with 'a', and finally those that start with 't'. How do we 
generate the permutations that start with 'e'? Make another PermutationIterator 
object (called tailIterator) that iterates through the permutations of the substring 
"at". In the nextPermutation method, simply ask tailIterator what its next permu- 
tation is, and then add the 'e' at the front. However, there is one special case. When 
the tail generator runs out of permutations, all permutations that start with the cur- 
rent letter have been enumerated. Then 


e Increment the current position. 
¢ Compute the tail string that contains all letters except for the current one. 
¢ Make a new permutation iterator for the tail string. 
You are done when the current position has reached the end of the string. 
kee Exercise P13.12. The following class generates all permutations of the numbers 
0,1,2,...,2—-1, without using recursion. 


public class NumberPermutationIterator 


{ 
public NumberPermutationIterator(int n) 
id 
a = new int[n]; 
done = false; 
for (int i = 0; i < n; i++) ali] = 1; 
} 
public int[] nextPermutation() 
{ 
if (a. length <= 1) return a; 
for Cint i = a. length - 1; 1 > 0; 1--) 
{ 
if cafi - 1] < ali]) 
if 
int j = a.length - 1; 
while (afi - 1] > a[j]) j--; 
swap(i - 1, j); 
reverse(i1, a. length - 1); 
return a; 
} 
; 
return a; 
} 


public boolean hasMorePermutations() 
{ 
if (a.length <= 1) return false; 
for Cint 1 = a. length - 1; 1 > 0; 1--) 
{ 
if cali - 1] < ali]) return true; 


} 


return false; 
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} 
public void swapCint i, int j) 
{ 
int temp = a[il]; 
ali] = aljl; 
aLj] = temp; 
} 
public void reverse(int i, int j) 
{ 
while (i < j) { swap(i, j); i++; j--; } 
} 


private int[] a; 

} 
The algorithm uses the fact that the set to be permuted consists of distinct numbers. 
Thus, you cannot use the same algorithm to compute the permutations of the char- 
acters in a string. You can, however, use this class to get all permutations of the 
character positions and then compute a string whose ith character is 
word.charAt(a[i]). Use this approach to reimplement the PermutationIterator of 
Exercise P13.11 without recursion. 


Exercise P13.13. Towers of Hanoi. This is a well-known puzzle. A stack of disks of 
decreasing size is to be transported from the leftmost peg to the rightmost peg. The 
middle peg can be used as temporary storage (see Figure 5). One disk can be moved 
at one time, from any peg to any other peg. You can place smaller disks only on top 
of larger ones, not the other way around. 


Write a program that prints the moves necessary to solve the puzzle for 7 disks. 
(Ask the user for 7 at the beginning of the program.) Print moves in the form 


Move disk from peg 1 to peg 3 

Hint: Implement a class DiskMover. The constructor takes 
¢ The source peg from which to move the disks (1, 2, or 3) 
e The target peg to which to move the disks (1, 2, or 3) 


¢ The number of disks to move 


Figure 5 Towers of Hanoi 
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A disk mover that moves a single disk from one peg to another simply has a 
nextMove method that returns a string 


Move disk from peg source to peg target 


A disk mover with more than one disk to move must work harder. It needs another 
DiskMover to help it. In the constructor, construct a DiskMover(source, other, 
disks - 1) where other is the peg other than from and target. 


The nextMove asks that disk mover for its next move until it is done. The effect is to 
move the first disks - 1 disks to the other peg. Then the nextMove method issues a 
command to move a disk from the from peg to the to peg. Finally, it constructs 
another disk mover DiskMover(other, target, disks - 1) that generates the moves 
that move the disks from the other peg to the target peg. 


Hint: It helps to keep track of the state of the disk mover: 


@ BEFORE_LARGEST: The helper mover moves the smaller pile to the other peg. 
® LARGEST: Move the largest disk from the source to the destination. 


® AFTER_LARGEST: The helper mover moves the smaller pile from the other peg to 
the target. 


@ pONE: All moves are done. 


Test your program as follows: 


DiskMover mover = new DiskMover(1, 3, n); 
while Cmover.hasMoreMoves()) 
System.out.println(mover.nextMove() ); 


Exercise P13.14. Escaping a Maze. You are currently located inside a maze. The walls 
of the maze are indicated by asterisks (*). 


Use the following recursive approach to check whether you can escape from the 
maze: If you are at an exit, return true. Recursively check whether you can escape 
from one of the empty neighboring locations without visiting the current location. 
This method merely tests whether there is a path out of the maze. Extra credit if 
you can print out a path that leads to an exit. 


Exercise P13.15. The Koch Snowflake. A snowflake-like shape is recursively defined 
as follows. Start with an equilateral triangle: 


< 


Next, increase the size by a factor of three and replace each straight line with four 
line segments. 
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Repeat the process. 


Write a program that draws the iterations of this curve. Supply a button that, when 
clicked, produces the next iteration. 


Exercise P13.16. The recursive computation of Fibonacci numbers can be speeded up 
significantly by keeping track of the values that have already been computed. Pro- 
vide an implementation of the fib method that uses this strategy. Whenever you 
return a new value, also store it in an auxiliary array. However, before embarking on 
a computation, consult the array to find whether the result has already been com- 
puted. Compare the running time of your improved implementation with that of 
the original recursive implementation and the loop implementation. 


Additional programming exercises are available in WileyPLUS. 


Project 13.1. Enhance the expression parser of Section 13.5 to handle more sophisti- 
cated expressions, such as exponents, and mathematical functions, such as sqrt or 
Sin. 


Project 13.2. Implement a graphical version of the Towers of Hanoi program (see 
Exercise P13.13). Every time the user clicks on a button labeled “Next”, draw the 
next move. 
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ANSWERS TO SELF-CHECK QUESTIONS 


1; 


10. 


11. 


Suppose we omit the statement. When computing the area of a triangle with 
width 1, we compute the area of the triangle with width 0 as 0, and then add 1, 
to arrive at the correct area. 


You would compute the smaller area recursively, then return 

smallerArea + width + width - 1. 

CICICIC] 

C0010 

CJC] 00] 

LICICICI 

Of course, it would be simpler to compute the area simply as width * width. 
The results are identical because 


_ n(n +1), (n—I)n 242. 
2 2 


Lo a2 bio 2a a 


. They are b followed by the six permutations of eat, e followed by the six per- 


mutations of bat, a followed by the six permutations of bet, and t followed by 
the six permutations of bea. 


. Simply change if (word.lengthQ) == 0) to if (word.JengthQ) <= 1), because a 


word with a single letter is also its sole permutation. 


. No—the first one could be given a different name such as 


substringIsPalindrome. 


When start >= end, that is, when the investigated string is either empty or has 


length 1. 


No, the recursive solution is about as efficient as the iterative approach. Both 
require 2 — 1 multiplications to compute 7!. 


An iterative solution would have a loop whose body computes the next permu- 
tation from the previous ones. But there is no obvious mechanism for getting 
the next permutation. For example, if you already found permutations eat, eta, 
and aet, it is not clear how you use that information to get the next permuta- 
tion. Actually, there is an ingenious mechanism for doing just that, but it is far 
from obvious—see Exercise P13.12. 


Factors are combined by multiplicative operators (* and /), terms are combined 
by additive operators (+, -). We need both so that multiplication can bind more 
strongly than addition. 


To handle parenthesized expressions, such as 2+3*(4+5). The subexpression 4+5 
is handled by a recursive call to getExpressionValue. 


The Integer.parseInt call in getFactorValue throws an exception when it is 
given the string ")". 


o dae in | performance 


To understand the big-Oh notation 


To learn how to estimate and compare the performance 
of algorithms 


To learn how to measure the running time of a program 


Ohne of the most common tasks in data processing is sorting. For example, a 
collection of employees may need to be printed out in alphabetical order or sorted 
by salary. We will study several sorting methods in this chapter and compare their 
performance. This is by no means an exhaustive treatment of the subject of sorting. 
You will likely revisit this topic at a later time in your computer science studies. A 
good overview of the many sorting methods available can be found in [1]. 

Once a sequence of objects is sorted, one can locate individual objects rapidly. 


We will study the binary search algorithm, which carries out this fast lookup. 
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In this section, we show you the first of several sorting algorithms. A sorting algo- 
rithm rearranges the elements of a collection so that they are stored in sorted order. 
To keep the examples simple, we will discuss how to sort an array of integers before 
going on to sorting strings or more complex data. Consider the following array a: 


119 17 3 12 
The celeoieeon An obvious first step 1s to find the smallest element. In this case the 
aloovithin sor 2 an array smallest element is 5, stored in a[3]. We should move the 5 to the 
by repeatedly finding the beginning of the array. Of course, there is already an element stored 
smallest element of the in a[0], namely 11. Therefore we cannot simply move a[3] into a[0] 
unsorted tail region and without moving the 11 somewhere else. We don’t yet know where 
moving it to the front. the 11 should end up, but we know for certain that it should not be 


in a[0]. We simply get it out of the way by swapping it with a[3]. 


Now the first element is in the correct place. In the foregoing figure, the darker 
color indicates the portion of the array that is already sorted. 


Next we take the minimum of the remaining entries a[1] 


. af4]. That mini- 


mum value, 9, is already in the correct place. We don’t need to do anything in this 
case and can simply extend the sorted area by one to the right: 


a7 il i2 
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Repeat the process. The minimum value of the unsorted region is 11, which needs 
to be swapped with the first value of the unsorted region, 17: 


Now the unsorted region is only two elements long, but we keep to the same suc- 
cessful strategy. The minimum value is 12, and we swap it with the first value, 17. 


That leaves us with an unprocessed region of length 1, but of course a region of 
length 1 is always sorted. We are done. 

Let us program this algorithm. For this program, as well as the other programs in 
this chapter, we will use a utility method to generate an array with random entries. 
We place it into a class ArrayUti1 so that we don’t have to repeat the code in every 
example. To show the array, we call the static toString method of the Arrays class in 
the Java library and print the resulting string. 

This algorithm will sort any array of integers. If speed were not an issue, or if 
there simply were no better sorting method available, we could stop the discussion 
of sorting right here. As the next section shows, however, this algorithm, while 
entirely correct, shows disappointing performance when run on a large data set. 

Advanced Topic 14.1 discusses insertion sort, another simple (and similarly 
inefficient) sorting algorithm. 


ch14/selsort/SelectionSorter.java 
/* * 


1 
Z This class sorts an array, using the selection sort 
3 algorithm. 
4 */ 
5 public class SelectionSorter 
6 { 
7 [ee 
8 Constructs a selection sorter. 
9 @param anArray the array to sort 
10 
11 


“ye 
public SelectionSorter(Gint[] anArray) 
iz { 
13 a = anArray; 
14 } 
15 
16 [wr 
17 Sorts the array managed by this selection sorter. 
18 a 
19 public void sort() 
20 { 
21 for Cint i = 0; 1 < a.length - 1; i++) 
ee { 


23 int minPos = minimumPosition(i) ; 
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swap(minPos, 1); 


} 
: 
/* % 
Finds the smallest element in a tail range of the array. 
@param from the first position in a to compare 
@return the position of the smallest element in the 
rangea[from] . . . alfa. length - 1] 
tf 
private int minimumPosition(Cint from) 
‘ 
int minPos = from; 
for Cint i = from + 1; 1 < a. length; i++) 
if Cali] < a[minPos]) minPos = 1; 
return minPos; 
} 
[** 
Swaps two entries of the array. 
@param 7 the first position to swap 
@param j the second position to swap 
a 
private void swapCint 1, int j) 
{ 
int temp = a[i]; 
ali] = a(j]; 
aj] = temp; 
} 


private int[] a; 


ch14/selsort/SelectionSortDemo.java 


{ 


Oo OOn™ om WN pt 


/ kt 


import java.util.Arrays; 


This program demonstrates the selection sort algorithm by 
sorting an array that is filled with random numbers. 


public class SelectionSortDemo 


public static void main(String[] args) 


{ 
int{] a = ArrayUtil.randomIntArray(20, 100); 
System.out.printIn(Arrays.toString(a) ); 
SelectionSorter sorter = new SelectionSorter (a) ; 
sorter.sort(); 
System.out.printIn(Arrays.toString(a)) ; 

} 
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ch14/selsort/ArrayUtil.java 


1 import java.util.Random; 
2 
3 [e% 
a This class contains utility methods for array manipulation. 
5 * / 
6 public class ArrayUtil 
7 { 
8 [e* 
9 Creates an array filled with random values. 
10 @param length the length of the array 
11 @param n the number of possible random values ; 
12 @return an array filled with length numbers between 
13 Oandn - 1 
14 rs 
15 public static int[] randomIntArray(int length, int n) 
16 { 
17 int[] a = new int[length]; 
18 for Gint i = 0; i < a.length; i++) 
19 ali] = generator.nextInt(n) ; 
20 
Zi return a; 
22 } 
23 
24 private static Random generator = new Random(); 
25 3} 
Typical Output 


[65, 46, 14, 52, 38, 2, 96, 39, 14, 33, 13, 4, 24, 99, 89, 77, 73, 87, 36, 81] 
[2, 4, 13, 14, 14, 24, 33, 36, 38, 39, 46, 52, 65, 73, 77, 81, 87, 89, 96, 99] 


SELF CHECK 


1. Why do we need the temp variable in the swap method? What would happen if 
you simply assigned a[i] to a[j] and a[j] to ali]? 


2. What steps does the selection sort algorithm go through to sort the sequence 
654321? 


ofili 


To measure the performance of a program, you could simply run it and measure 
how long it takes by using a stopwatch. However, most of our programs run very 
quickly, and it is not easy to time them accurately in this way. Furthermore, when a 
program takes a noticeable time to run, a certain amount of that time may simply be 
used for loading the program from disk into memory (for which we should not 
penalize it) or for screen output (whose speed depends on the computer model, 
even for computers with identical CPUs). We will instead create a StopWatch class. 
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This class works like a real stopwatch. You can start it, stop it, and read out the 
elapsed time. The class uses the System.currentTimeMillis method, which returns 
the milliseconds that have elapsed since midnight at the start of January 1, 1970. Of 
course, you don’t care about the absolute number of seconds since this historical 
moment, but the difference of two such counts gives us the number of milliseconds 


of a time interval. Here is the code for the Stopwatch class: 


ch14/selsort/StopWatch.java 


l / ars 


food fred feol foal foal 
PWNHHOWOONAURPWN 


A stopwatch accumulates time when it is running. You can 
sees! start and stop the stopwatch. You can use a 
stopwatch to measure the running time of a program. 


public class StopWatch 
{ 


/* % 
Constructs a stopwatch that is in the stopped state 
and has no time accumulated. 


* f 
public StopWatch() 


{ 
reset(); 
: 
j* % . 
Starts the stopwatch. Time starts accumulating now. 
* / 


public void start() 


if CisRunning) return; 
1sRunning = true; 
startTime = System.currentTimeMillisQ; 


ale ale 
aoa 


Stops the stopwatch. Time stops accumulating and is 
is added to the elapsed tume. 
% / 
public void stop() 
{ 
if ClisRunning) return; 
isRunning = false; 


long endTime = System.currentTimeMillis(); 
elapsedTime = elapsedTime + endTime - startTime; 


Returns the total elapsed time. 
@return the total elapsed time 


ve / 
public long getElapsedTime() 


if CisRunning) 
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46 f 

47 long endTime = System.currentTimeMillis(); 
48 return elapsedTime + endTime - startTime; 
49 } 

50 else 

51 return elapsedTime; 

52 } 

53 

54 we 

55 Stops the watch and resets the elapsed time to 0, 
56 * / 

57 public void reset() 

58 { 

59 elapsedTime = 0); 

60 isRunning = false; 

61 } 

62 

63 private long elapsedTime; 

64 private long startTime; 

65 private boolean isRunning; 

66 }3 


Here is how we will use the stopwatch to measure the performance of the sorting 
algorithm: 


ch14/selsort/SelectionSortTimer.java 


1 import java.util.Scanner; 


2 
3 Wek 
4 This program measures how long it takes to sort an 
5 array of a user-specified size with the selection 
6 sort algorithm, 
8 public class SelectionSortTimer 
9 
10 public static void main(String[] args) 
11 { 
12 Scanner in = new Scanner(System.in); 
13 System.out.print("Enter array size: "); 
14 int n = in.nextInt(): 
15 
16 // Construct random array 
17 
18 int{] a = ArrayUtil.randomIntArray(n, |); 
19 SelectionSorter sorter = new SelectionSorter(a); 
20 
P| // Use stopwatch to time selection sort 
22 | 
23 StopWatch timer = new StopWatch(); 
24 
25 timer.startQ); 
26 sorter.sort(): 


27 timer.stop(); 
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t 


29 System.out.printInC"Elapsed time: 
30 + timer.getElapsedTime() + 


i" 


milliseconds"); 


Output 


Enter array size: 100000 
Elapsed time: 27880 milliseconds 


By starting to measure the time just before sorting, and stopping the stopwatch just 
after, you don’t count the time it takes to initialize the array or the time during 
which the program waits for the user to type in n. 

Here are the results of some sample runs: 


Time (seconds) 


Figure 1 Time Taken by Selection Sort 


n Milliseconds 
10,000 786 
20,000 2,148 
30,000 4,796 
40,000 9,192 

50,000 13,321 
60,000 19,299 


n (thousands) 


14.3 
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These measurements were obtained with a Pentium processor with a clock speed of 
2 GHz, running Java 6 on the Linux operating system. On another computer the 
actual numbers will look different, but the relationship between the numbers will 
be the same. Figure 1 shows a plot of the measurements. As you can see, doubling 
the size of the data set more than doubles the time needed to sort it. 


SELF CHECK 


3. Approximately how many seconds would it take to sort a data set of 80,000 
values? 


4. Look at the graph in Figure 1. What mathematical shape does it resemble? 


Analyzing the Performance of the 


Let us count the number of operations that the program must carry out to sort an 
array with the selection sort algorithm. We don’t actually know how many machine 
operations are generated for each Java instruction or which of those instructions are 
more time-consuming than others, but we can make a simplification. We will simply 
count how often an array element is visited. Each visit requires about the same amount 
of work by other operations, such as incrementing subscripts and comparing values. 

Let 2 be the size of the array. First, we must find the smallest of 2 numbers. ‘To 
achieve that, we must visit 7 array elements. Then we swap the elements, which 
takes two visits. (You may argue that there is a certain probability that we don’t 
need to swap the values. That is true, and one can refine the computation to reflect 
that observation. As we will soon see, doing so would not affect the overall conclu- 
sion.) In the next step, we need to visit only 7 — 1 elements to find the minimum. In 
the following step, 7 — 2 elements are visited to find the minimum. The last step vis- 
its two elements to find the minimum. Each step requires two visits to swap the ele- 
ments. Therefore, the total number of visits is 


n+24+(n—-1)+24--+242=n4+(n—-1)4+-:-+24+(n-1)-2 


24+---+(n-1)+n+(n—-1)-2 
= AFD 14 (n-1)-2 


because 


ee eee ee ea 


After multiplying out and collecting terms of 2, we find that the number of visits is 
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the big-Oh notation 
-O(g(n)) to express 
that the function f grows no 
faster than the function g. 


f(n) = 


Selection sort isan O(n 
algorithm. Doubling the 
data set means a fourfold 
increase in processing time. 
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We obtain a quadratic equation in 7. That explains why the graph of Figure 1 looks 
approximately like a parabola. 

Now let us simplify the analysis further. When you plug in a large value for 
(for example, 1,000 or 2,000), then 4 sn is 500,000 or 2,000,000. The lower term, 
on — 3, doesn’t contribute much af all; it is only 2,497 or 4,997, a drop in the 
bucket compared to the hundreds of dieusandscr ech millones comparisons 
specified by the 1? term. We will just ignore these lower-level terms. Next, we 
will ignore the constant factor +. We are not interested in the actual count of visits 
for a single 7. We want to compare the ratios of counts for different values of 7. For 
example, we can say that sorting an array of 2,000 numbers requires four times as 
many visits as sorting an array of 1,000 numbers: 


1 pn 
(! 2000 ] 


rere. 
(2 1000 


= 4 


The factor + cancels out in comparisons of this kind. We will simply say, “The num- 
ber of visits is of order n*”. That way, we can easily see that the number of 
comparisons increases fourfold when the size of the array doubles: (2n)* = An? 

To indicate that the number of visits is of order n*, computer scientists often use 
big-Oh notation: The number of visits is O(77). This is a convenient shorthand. 

In general, the expression f(7) = O(g(7)) means that f grows no 
faster than g, or, more formally, that for all 7 larger than some thresh- 
old, the ratio f(n)/g(n) < C for some constant value C. The func- 
tion g is usually chosen to be very simple, such as n in our example. 

To turn an exact expression such as 


i 7 


1y2 4 3y 
2 rca 


into big-Oh notation, simply locate the fastest-growing term, n*, and ignore its 
constant coefficient, no matter how large or small it may be. 

We observed before that the actual number of machine operations, and the actual 
number of microseconds that the computer spends on them, is approximately pro- 
portional to the number of element visits. Maybe there are about 10 machine oper- 
ations (increments, comparisons, memory loads, and stores) for every, element 
visit. The number of machine operations is then approximately 10 x 47. Again, 
we aren’t interested in the coefficient, so we can say that the number, of machine 
operations, and hence the time spent on the sorting, is of the order of n* or O(n’). 

The sad fact remains that doubling the size of the array causes a 
fourfold increase in the time required for sorting it with selection 
sort. When the size of the array increases by a factor of 100, the sort- 
ing time increases by a factor of 10,000. To sort an array of a million 
entries, (for example, to create a telephone directory) takes 10,000 
times as long as sorting 10,000 entries. If 10,000 entries can be sorted in 
about 1/2 of a second (as in our example), then sorting one million entries requires 
well over an hour. We will see in the next section how one can dramatically improve 
the performance of the sorting process by choosing a more sophisticated algorithm. 
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SELF CHECK 


5. If you increase the size of a data set tenfold, how much longer does it take to 
sort it with the selection sort algorithm? 


6. How large does 7 need to be so that sn is bigger than on — 3? 


ADVANCED Topic 14.1 


Insertion Sort 


Insertion sort is another simple sorting algorithm. In this algorithm, we assume that the in1- 
tial sequence 


a(O] a[1] . . . a[k] 
of an array is already sorted. (When the algorithm starts, we set k to 0.) We enlarge the initial 
sequence by inserting the next array element, a[k + 1], at the proper location. When we 


reach the end of the array, the sorting process is complete. 
For example, suppose we start with the array 


Of course, the initial sequence of length 1 is already sorted. We now add a[1], which has the 
value 9. The element needs to be inserted before the element 11. The result 1s 


Next, we add a[2], which has the value 16. As it happens, the element does not have to be 
moved. 


We repeat the process, inserting a[3] or 5 at the very beginning of the initial sequence. 


Finally, a[4] or 7 is inserted in its correct position, and the sorting is completed. 
The following class implements the insertion sort algorithm: 


public class InsertionSorter 
{ 
y* se 
Constructs an insertion sorter. 
@param anArray the array to sort 
* / 
public InsertionSorter(int[] anArray) 
{ 
a = anArray; 


; 
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Sorts the array managed by this insertion sorter. 
* / 
public void sort() 
{ 
for (int 1 = 1; i < a.length; i++) 
{ 
int next = a[i];_ 
// Find the insertion location 
// Move all larger elements up 
Int Jj = 1; 
while (j > 0 && a[j - 1] > next) 


a{j] = a[j - 1); 
I=; 


// Insert the element 
a[j] = next; 


} 


private int[] a; 
} 
How efficient is this algorithm? Let 7 denote the size of the array. We carry out 7 — 1 itera- 
tions. In the kth iteration, we have a sequence of k elements that is already sorted, and we 
need to insert a new element into the sequence. For each insertion, we need to visit the ele- 
ments of the initial sequence until we have found the location in which the new element can 
be inserted. Then we need to move up the remaining elements of the sequence. Thus, k + 1 
array elements are visited. Therefore, the total number of visits is 


n(n+I) _ 
2 


24g 1 


We conclude that insertion sort is an O(n’) algorithm, on the 
same order of efficiency as selection sort. 

Insertion sort has one desirable property: Its performance 
is O(n) if the array is already sorted—see Exercise R14.13. 
This is a useful property in practical applications, in which data sets are often partially sorted. 


sort isan O(n?) 


ADVANCED ToPic 14.2 


Oh, Omega, and Theta 


We have used the big-Oh notation somewhat casually in this chapter, to describe the growth 
behavior of a function. Strictly speaking, f(7) = O(g(2)) means that f grows no faster than g. 
But it is permissible for f to grow much slower. Thus, it is technically correct to state that 
fn) =n? + 5n —3 is O(n?) or even O(n!°). 

Computer scientists have invented additional notation to describe the growth behavior of 
functions more accurately. The expression 


fl) = Q(g(n)) 
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means that f grows at least as fast as g, or, formally, that for all 7 larger than some threshold, 
the ratio f(2)/g(n) = C for some constant value C. (The Q symbol is the capital Greek letter 
omega.) For example, f(7) = n? +5n —3 is Q(n’) or even Q(n). 

The expression 


f(n) = O(g()) 


means that f and g grow at the same rate—that is, both f(7) = O(g(2)) and f(7) = Q(g(7)) hold. 
(The © symbol is the capital Greek letter theta.) 

The © notation gives the most precise description of growth behavior. For example, f(72) = 
n2 +5n —3 is O(n’) but not O(n) or O(n°). 

The Q and © notation is very important for the precise analysis of algorithms. However, 
in casual conversation it is common to stick with big-Oh, while still giving as good an esti- 
mate as one can. 


In this section, you will learn about the merge sort algorithm, a much more efficient 
algorithm than selection sort. The basic idea behind merge sort is very simple. 
Suppose we have an array of 10 integers. Let us engage in a bit of wishful think- 


ing and hope that the first half of the array is already perfectly sorted, and the sec- 
ond half is too, like this: 


Now it is simple to merge the two sorted arrays into one sorted array, by taking a 
new element from either the first or the second subarray, and choosing the smaller 
of the elements each time: 


In fact, you probably performed this merging before when you and a friend had to 
sort a pile of papers. You and the friend split the pile in half, each of you sorted 
your half, and then you merged the results together. 
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That is all well and good, but it doesn’t seem to solve the problem 
for the computer. It still must sort the first and second halves of the 
array, because it can’t very well ask a few buddies to pitch in. As it 
turns out, though, if the computer keeps dividing the array into 
smaller and smaller subarrays, sorting each half and merging them 
back together, it carries out dramatically fewer steps than the selec- 
tion sort requires. 

Let us write a MergeSorter class that implements this idea. When the MergeSorter 
sorts an array, it makes two arrays, each half the size of the original, and sorts them 
recursively. Then it merges the two sorted arrays together: 


The merge sort algorithm — 
sorts an array by cutting 
thearrayinhalf, 
_ recursively sorting 
half, and then merg 
sorted halves. 


public void sort() 


{ 
1f Ca. length <= 1) return; 
intl] first = new int[a.length / 2]; 
int[] second = new int[a.length - first. length]; 
System.arraycopy(a, 0, first, 0, first. length); 
System.arraycopy(a, 

first.length, second, 0, second.length) ; 

MergeSorter firstSorter = new MergeSorter(first); 
MergeSorter secondSorter = new MergeSorter(second) ; 
fFirstsorter.sort() : 
secondSorter.sort(); 
merge(first, second); 

} 


The merge method is tedious but quite straightforward. You will find it in the code 
that follows. 


ch14/mergesort/MergeSorter.java 


1 
2 This class sorts an array, using the merge sort algorithm. 
Ss. */ 
4 public class MergeSorter 
> { 
6 baie 
7 Constructs a merge sorter. 
8 @param anArray the array to sort 
9 “ 
10 public MergeSorter(int[] anArray) 
11 { 
12 a = anArray; 
13 } 
14 
15 i 
16 Sorts the array managed by this merge sorter. 
17 */ 
18 public void sort() 
19 { 
20 if (a.length <= 1) return; 
21 intl] first = new int[a.length / 2]; 


ce int[] second = new int[a.length - first.length]; 
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23 System.arraycopy(a, 0, first, 0, first. length) ; 

24 System.arraycopy(a, first.length, second, 0, second. | ength) ; 
25 MergeSorter firstSorter = new MergeSorter(first) ; 
26 MergeSorter secondSorter = new MergeSorter (second) ; 
27 firstSorter.sortQ: 

28 secondSorter.sort(); 

29 merge(first, second) ; 

30 } 

31 

32 [** 

33 Merges two sorted arrays into the array managed by this 

34 merge sorter. 

35 @param first the first sorted array 

36 @param second the second sorted array 

37 * / 

38 private void mergeC(int[] first, int[] second) 

39 { 

40 // Merge both halves into the temporary array 

41 

42 int iFirst = 0; 

43 // Next element to consider in the first array 

ae int iSecond = 0; 

45 // Next element to consider in the second array 

46 int j = 0; 

47 // Next open position in a 

48 

49 // As long as neither iFirst nor iSecond past the end, move 
50 // the smaller element into a 

51 while (iFirst < first.length && iSecond < second. length) 
52 

53 if (first[iFirst] < second[iSecond]) 

54 { 

55 a{j] = first[iFirst]; 

56 iFirst++; 

57 } 

58 else 

59 { 

60 a[j] = second[iSecond] ; 

61 i Second++; 

62 } 

63 j++; 

64 } 

65 

66 // Note that only one of the two calls to arraycopy below 
67 // copies entries 

68 

69 // Copy any remaining entries of the first array 

70 System.arraycopy(first, iFirst, a, j, first.length - iFirst); 
71 

72 // Copy any remaining entries of the second half 

73 System.arraycopy(second, iSecond, a, j, second.length - iSecond) ; 
74 7 

75 

76 private int[] a; 


77 3} 
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ch14/mergesort/MergeSortDemo.java 


1 import java.util.Arrays; 
1 
l /* * 
2 This program demonstrates the merge sort algorithm by 
3 sorting an array that is filled with random numbers. 
4 * 7] 
5 public class MergeSortDemo 
6 { 
7 public static void main(String[] args) 
8 { 
9 intl] a = ArrayUtil.randomIntArray(20, 100); 
10 System.out.printIn(Arrays.toString(a)); 
11 MergeSorter sorter = new MergeSorter(a); 
12 sorter.sort(); 
13 System.out.printIn(Arrays.toString(a)); 
14 } 
15 } 
Typical Output 


[8, 81, 48, 53, 46, 70, 98, 42, 27, 76, 33, 24, 2, 76, 62, 89, 90, 5, 13, 21] 
[2, 5, 8, 13, 21, 24, 27, 33, 42, 46, 48, 53, 62, 70, 76, 76, 81, 89, 90, 98] 


SELF CHECK 


7. Why does only one of the two arraycopy calls at the end of the merge method do 
any work? 


8. Manually run the merge sort algorithm on the array 87654321. 


The merge sort algorithm looks a lot more complicated than the selection sort algo- 
rithm, and it appears that it may well take much longer to carry out these repeated 
subdivisions. However, the timing results for merge sort look much better than 
those for selection sort (see table on next page). 

Figure 2 shows a graph comparing both sets of performance data. That is a tre- 
mendous improvement. To understand why, let us estimate the number of array ele- 
ment visits that are required to sort an array with the merge sort algorithm. First, let 
us tackle the merge process that happens after the first and second halves have been 
sorted. 

Each step in the merge process adds one more element to a. That element may 
come from first or second, and in most cases the elements from the two halves 
must be compared to see which one to take. Let us count that as 3 visits (one for a 
and one each for first and second) per element, or 37 visits total, where 7 denotes 
the length of a. Moreover, at the beginning, we had to copy from a to first and 
second, yielding another 27 visits, for a total of 57. 
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Merge Sort 
n (milliseconds) 
10,000 40 
20,000 13 
30,000 134 
40,000 170 
50,000 192 
60,000 a 205 


Selection Sort 
(milliseconds) 


786 
2,148 
4,796 
9,192 
135321 
19,299 
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If we let T(n) denote the number of visits required to sort a range of m elements 


through the merge sort process, then we obtain 


T(n) = (2) + 7] + 5n 


because sorting each half takes T (7/2) visits. Actually, if 7 is not even, then we have 
one subarray of size (7 —1)/2 and one of size (7 + 1)/2. Although it turns out that 
this detail does not affect the outcome of the computation, we will nevertheless 
assume for now that n is a power of 2, say n = 2”. That way, all subarrays can be 


evenly divided into two parts. 


Time (seconds) 


n (thousands) 


Figure 2 


Merge Sort Timing (blue) versus Selection Sort (red) 
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Unfortunately, the formula 
T(n) = ar{) + 5n 


does not clearly tell us the relationship between n and T(z). To understand the rela- 
tionship, let us evaluate T(n/2), using the same formula: 


rs}oatlt} +95 


Tini=2< ar{) +5n+5n 


ra}oatla) 93 


Tw) =2x2xat|2|45n-+50+5n 


Therefore 
Let us do that again: 
hence 


This generalizes from 2, 4, 8, to arbitrary powers of 2: 
T(n) = a7[ = + 5nk 
9k 
Recall that we assume that 2 = 2”; hence, for k =m, 


(n)= apd + 5nm 
Qin 
=nI(1)+5nm 
=n + 5nlog,(n) 


Because n = 2””, we have m = log,(n). 

To establish the growth order, we drop the lower-order term 7 and are left with 
5n logs(n). We drop the constant factor 5. It is also customary to drop the base of 
the logarithm, because all logarithms are related by a constant factor. For example, 


log, (x) = log, 9(x)/log1)(2) = logs (x) X 3.32193 


Hence we say that merge sort is an O(n log(n)) algorithm. 


\ 
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ee i Is the O(n log(7)) merge sort algorithm better than the O(n’) selec- 

seit 3 ne saa tion sort algorithm? You bet it is. Recall that it took 1007 = 10,000 
function grows much more _—‘ times as long to sort a million records as it took to sort 10,000 
slowly than n2. — | records with the O(n”) algorithm. With the O(7 log(z)) algorithm, 
cai the ratio is 


1,000, 000log (1,000,000) _ foo 450 
10,000 log (10,000) 


Suppose for the moment that merge sort takes the same time as selection sort to sort 
an array of 10,000 integers, that is, 3/4 of a second on the test machine. (Actually, it 
is much faster than that.) Then it would take about 0.75 x 150 seconds, or under 2 
minutes, to sort a million integers. Contrast that with selection sort, which would 
take over 2 hours for the same task. As you can see, even if it takes you several 
hours to learn about a better algorithm, that can be time well spent. 

In this chapter we have barely begun to scratch the surface of this interesting 
topic. There are many sorting algorithms, some with even better performance than 
the merge sort algorithm, and the analysis of these algorithms can be quite challeng- 
ing. If you are a computer science major, you may revisit these important issues 1n a 
later computer science class. 

However, when you write Java programs, you don’t have to 
implement your own sorting algorithm. The Arrays class contains 
static sort methods to sort arrays of integers and floating-point num- 
bers. For example, you can sort an array of integers simply as 


IHC) aS Be a es 
Arrays.sort(a) ; 


That sort method uses the quicksort algorithm—see Advanced Topic 14.3 for more 
information about that algorithm. 


SELF CHECK 


9. Given the timing data for the merge sort algorithm in the table at the beginning 
of this section, how long would it take to sort an array of 100,000 values? 


10. Suppose you have an array double[] values in a Java program. How would you 
sort 1t? 


ADVANCED Topic 14.3 


The Quicksort Algorithm 


Quicksort is a commonly used algorithm that has the advantage over merge sort that no tem- 
porary arrays are required to sort and merge the partial results. 

The quicksort algorithm, like merge sort, is based on the strategy of divide and conquer. 
To sort a range a[from] . . . a[to] of the array a, first rearrange the elements in the range 
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so that no element in the range a[from] . . . a[p] is larger than any element in the range 
afp + 1] . . . a[to]. This step is called partitioning the range. 
For example, suppose we start with a range 


> 3264127 
Here is a partitioning of the range. Note that the partitions aren’t yet sorted. 
3 3244/6 5 2 


You'll see later how to obtain such a partition. In the next step, sort each partition, by recur- 
sively applying the same algorithm on the two partitions. That sorts the entire range, because 
the largest element in the first partition is at most as large as the smallest element in the sec- 
ond partition. 


Quicksort is implemented recursively as follows: 


public void sort(int from, int to) 


{ 
if (from >= to) return; 
int p = partition(from, to); 
sort (from, p); 
sort(p + 1, to); 
} 


Let us return to the problem of partitioning a range. Pick an element from the range and call 
it the pivot. There are several variations of the quicksort algorithm. In the simplest one, we’ll 
pick the first element of the range, a[from], as the pivot. 


Now form two regions a[from] . . . ali], consisting of values at most as large as the 
pivot and a[j] . . . a[to], consisting of values at least as large as the pivot. The region 
afi + 1]. . . afj - 1] consists of values that haven’t been analyzed yet. (See Partitioning 


a Range.) At the beginning, both the left and right areas are empty; that is, i = from - 1 and 
j = to + 1. 


< pivot Not yet analyzed > pivot 


[from] ri] 


Partitioning a Range 


>pivot <pivot 


<pivot <pivot 


i=" aia, 


>pivot >pivot 


[from] [7 [to] 


Extending the Partitions 
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Then keep incrementing i while a[i] < pivot and keep decrementing j while aj] > 
pivot. Extending the Partitions shows i and j when that process stops. 

Now swap the values in positions i and j, increasing both areas once more. Keep going 
while i < j. Here is the code for the partition method: 


private int partition(int from, int to) 


{ 
int pivot = a[from]; 
int 1 = from - 1; 
int j = to + 1; 
while (i < j) 
{ 
i++; while (a[li] < pivot) 1++; 
j--; while (Ca[j] > pivot) j--; 
if Gi < j) swapGi, j); 
} 
return j; 
} 


On average, the quicksort algorithm is an O(7 log(n)) algorithm. Because it is simpler, it runs 
faster than merge sort in most cases. There is just one unfortunate aspect to the quicksort 
algorithm. Its worst-case runtime behavior is O(n’). Moreover, if the pivot element is chosen 
as the first element of the region, that worst-case behavior occurs when the input set 1s 
already sorted—a common situation in practice. By selecting the pivot element more clev- 
erly, we can make it extremely unlikely for the worst-case behavior to occur. Such “tuned” 
quicksort algorithms are commonly used, because their performance is generally excellent. 
For example, as was mentioned, the sort method in the Arrays class uses a quicksort 
algorithm. 

Another improvement that is commonly made in practice is to switch to insertion sort 
when the array is short, because the total number of operations of insertion sort is lower for 
short arrays. The Java library makes that switch if the array length is less than 7. 


RANDOM FACT 14.1 


The First Programmer 


Before pocket calculators and personal computers existed, navigators and engineers used 
mechanical adding machines, slide rules, and tables of logarithms and trigonometric func- 
tions to speed up computations. Unfortunately, the tables—for which values had to be 
computed by hand—were notoriously inaccurate. The mathematician Charles Babbage 
(1791-1871) had the insight that if a machine could be constructed that produced printed 
tables automatically, both calculation and typesetting errors could be avoided. Babbage set 
out to develop a machine for this purpose, which he called a Difference Engine because it 
used successive differences to compute polynomials. For example, consider the function 
f(x) = x3. Write down the values for f(1), f(2), f(3), and so on. Then take the differences 


between successive values: 
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Hi 

7 
8 

19 
27 

a7 
64 

61 
125 

91 
216 


Repeat the process, taking the difference of successive values in the second column, and then 
repeat once again: 


1 

vi 
8 12 

19 6 
Om 18 

37 6 
64 24 

61 6 
125 30 

91 
216 


Now the differences are all the same. You can retrieve the function values by a pattern of 
additions—you need to know the values at the fringe of the pattern and the constant differ- 
ence. This method was very attractive, because mechanical addition machines had been 
known for some time. They consisted of cog wheels, with 10 cogs per wheel, to represent 


Babbage’s Difference Engine 
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digits, and mechanisms to handle the carry from one digit to the next. Mechanical multiplica- 
tion machines, on the other hand, were fragile and unreliable. Babbage built a successful pro- 
totype of the Difference Engine (see the Babbage’s Difference Engine figure) and, with his 
own money and government grants, proceeded to build the table-printing machine. How- 
ever, because of funding problems and the difficulty of building the machine to the required 
precision, it was never completed. 

While working on the Difference Engine, Babbage conceived of a much grander vision 
that he called the Analytical Engine. The Difference Engine was designed to carry out a 
limited set of computations—it was no smarter than a pocket calculator is today. But Bab- 
bage realized that such a machine could be made programmable by storing programs as well 
as data. The internal storage of the Analytical Engine was to consist of 1,000 registers of 50 
decimal digits each. Programs and constants were to be stored on punched cards —a tech- 
nique that was, at that time, commonly used on looms for weaving patterned fabrics. 

Ada Augusta, Countess of Lovelace (1815-1852), the only child of Lord Byron, was a 
friend and sponsor of Charles Babbage. Ada Lovelace was one of the first people to realize 
the potential of such a machine, not just for computing mathematical tables but for process- 
ing data that were not numbers. She is considered by many the world’s first programmer. 
The Ada programming language, a language developed for use in U.S. Department of 
Defense projects (see Random Fact 9.2), was named in her honor. 


Suppose you need to find the telephone number of your friend. You look up his 
name in the telephone book, and naturally you can find it quickly, because the tele- 
phone book is sorted alphabetically. Quite possibly, you may never have thought 
how important it is that the telephone book is sorted. To see that, think of the fol- 
lowing problem: Suppose you have a telephone number and you must know to 
what party it belongs. You could of course call that number, but suppose nobody 
picks up on the other end. You could look through the telephone book, a number at 
a time, until you find the number. That would obviously be a tremendous amount 
of work, and you would have to be desperate to attempt that. 

This thought experiment shows the difference between a search through an 
unsorted data set and a search through a sorted data set. The following two sections 
will analyze the difference formally. 

If you want to find a number in a sequence of values that occur in 


A linear search examines arbitrary order, there is nothing you can do to speed up the search. 
all values in an array until = You must simply look through all elements until you have found a 
‘it finds a match or reaches match or until you reach the end. This is called a linear or sequential 
ae ine | search. 

eee How long does a linear search take? If we assume that the element 
A linear search locatesa —-v is present in the array a, then the average search visits 7/2 elements, 
eee anarrayin O(n) where 7 is the length of the array. If it is not present, then all n ele- 


ments must be inspected to verify the absence. Either way, a linear 
search is an O(7) algorithm. 
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Here 1s a class that performs linear searches through an array a of integers. When 
searching for the value v, the search method returns the first index of the match, or 
-11f v does not occur in a. 


ch14/linsearch/LinearSearcher.java 


1 
2 A class for executing linear searches through an array. 
3 2 
4 public class LinearSearcher 
> 4 
6 [** 
7 Constructs the LinearSearcher. 
8 @param anArray an array of integers 
9 a A 
10 public LinearSearcher(int[] anArray) 
li { 
12 a = anArray; 
13 } 
14 
15 pe 
16 Finds a value in an array, using the linear search 
17 algorithm. 
18 @param v the value to search 
19 @return the index at which the value occurs, or -1 
20 if it does not occur in the array 
21 a 
22 public int search(Cint v) 
23 { 
24 for (int i = 0; i < a.length; i++) 
25 { 
26 if cafi] == v) 
27 return i; 
28 } 
29 return -1; 
30 } 
31 
32 private int[] a; 
33} 


ch14/linsearch/LinearSearchDemo.java 


1 import java.util.Arrays; 
import java.util.Scanner; 


2 
3 
4 /** 

5 This program demonstrates the linear search algorithm. 
6 */ 

7 

8 


public class LinearSearchDemo 


{ 
9 public static void main(String[] args) 
10 { 
11 intl] a = ArrayUtil.randomIntArray(20, 10°); 


12 System.out.printIn(Arrays.toString(a)); 
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13 LinearSearcher searcher = new LinearSearcher(a) ; 

14 

15 Scanner in = new Scanner(System.in); 

16 

17 boolean done = false; 

18 while (!done) 

19 { 

20 System.out.print("Enter number to search for, -1 to quit: "); 
21 int n = in.nextintQ; 

22 if (n == -1) 

23 done = true; 

24 else 

25 { 

26 int pos = searcher.search(n); 

27 System.out.printInC'Found in position " + pos); 
28 } 

29 } 

30 } 

31 } 

Typical Output 


[46, 99, 45, 57, 64, 95, 81, 69, 11, 97, 6, 85, 61, 88, 29, 65, 83, 88, 45, 88] 
Enter number to search for, -1 to quit: 11 
Found in position 8 


SELF CHECK 


11. Suppose you need to look through 1,000,000 records to find a telephone num- 
ber. How many records do you expect to search before finding the number? 


12. Why can’t you use a “for each” loop for Cint element : a) in the search 
method? 


Binary 


Now let us search for an item in a data sequence that has been previously sorted. Of 
course, we could still do a linear search, but it turns out we can do much better than 
that. 

Consider the following sorted array a. The data set is: 


COILLIL2IL3IL4IL5ILEIL7] 


ae igus Tees Bie ‘Sigh 


We would like to see whether the value 15 is in the data set. Let’s narrow our search 
by finding whether the value is in the first or second half of the array. The last point 
in the first half of the data set, a[3], is 9, which is smaller than the value we are 
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looking for. Hence, we should look in the second half of the array for a match, that 
is, in the sequence: 


LS IT4]05I06](7] 


Now the last value of the first half of this sequence is 17; hence, the value must be 
located in the sequence: 


The last value of the first half of this very short sequence is 12, which is smaller than 
the value that we are searching, so we must look in the second half: 


It is trivial to see that we don’t have a match, because 15 ¥ 17. If we 
by Wanted to insert 15 into the sequence, we would need to insert it just 


determining whether the before a[5]. 

value occurs in the first or This search process is called a binary search, because we cut the 
second half, then = ~—_ size of the search in half in each step. That cutting in half works only 
repeating the searchin = ~— because we know that the sequence of values is sorted. 

one ofthe halves. The following class implements binary searches in a sorted array 


of integers. The search method returns the position of the match if 
the search succeeds, or -1 if v is not found in a. 


ch14/binsearch/BinarySearcher.java 


l [** 
2 A class for executing binary searches through an array. 
S +7 
4 public class BinarySearcher 
s 4 
6 [** 
7 Constructs a BinarySearcher. 
8 @param anArray a sorted array of integers 
a 
10 public BinarySearcher(int[] anArray) 
ll { 
12 a = anArray; 
13 } 
14 
Lee j** 
16 Finds a value in a sorted array, using the binary 
17 search algorithm. 
18 @param v the value to search 
19 @return the index at which the value occurs, or -1 
20 if it does not occur in the array 
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22 public int search(int v) 

23 { 

24 int low = 0; 

25 int high = a.length - 1; 

26 while (low <= high) 

27 { 

28 int mid = (low + high) / 2; 
29 int diff = a[mid] - v; 

30 

31 if ddiff == 0) // al[mid] == v 
52 return mid; 

33 else if (diff < 0) // a[mid] < v 
34 low = mid + 1; 

35 else 

36 high = mid - 1; 

37 

38 return -1; 

39 } 

40 

41 private int[] a; 

42 } 


Let us determine the number of visits of array elements required to carry out a 
search. We can use the same technique as in the analysis of merge sort. Because we 
look at the middle element, which counts as one comparison, and then search either 
the left or the right subarray, we have 


T(n) = r(#) 24 


‘(a}erla)e 


By plugging this result into the original equation, we get 


T(n) = r(#] op) 


Using the same equation, 


That generalizes to 


Ta)= (4) +k 


As in the analysis of merge sort, we make the simplifying assumption that 7 1s a 
power of 2, 7 = 2”, where m = log>(n). Then we obtain 


T(n) = 1+ log,(n) 


Therefore, binary search is an O(log(7)) algorithm. 
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That result makes intuitive sense. Suppose that 7 is 100. Then after 
each search, the size of the search range is cut in half, to 50, 25, 12, 6, 
3, and 1. After seven comparisons we are done. This agrees with our 
formula, because log,(100) ~ 6.64386, and indeed the next larger 
power of 2 is 2’ = 128. 

Because a binary search is so much faster than a linear search, is it worthwhile 
to sort an array first and then use a binary search? It depends. If you search the 
array only once, then it is more efficient to pay for an O() linear search than for 
an O(7 log(z)) sort and an O(log(7)) binary search. But if you will be making 
many searches in the same array, then sorting it is definitely worthwhile. 

The Arrays class contains a static binarySearch method that implements the 
binary search algorithm, but with a useful enhancement. If a value is not found in 
the array, then the returned value is not -1, but -k — 1, where k is the position before 
which the element should be inserted. For example, 

intt] a={1, 4, 9 }; 

int v = 7; 

int pos = Arrays.binarySearch(a, v); 

// Returns -3; v should be inserted before position 2 


IN Il 


SELF CHECK 


13. Suppose you need to look through a sorted array with 1,000,000 elements to 
find a value. Using the binary search algorithm, how many records do you 
expect to search before finding the value? 


14. Why is it useful that the Arrays.binarySearch method indicates the position 
where a missing element should be inserted? 


15. Why does Arrays. binarySearch return —k — 1 and not —k to indicate that a value 
is not present and should be inserted before position k? 


In this chapter we have studied how to search and sort arrays of integers. Of course, 
in application programs, there is rarely a need to search through a collection of inte- 
gers. However, it is easy to modify these techniques to search through real data. 
The Arrays class supplies a static sort method for sorting arrays of 
objects. However, the Arrays class cannot know how to compare 
arbitrary objects. Suppose, for example, that you have an array of Coin 
objects. It is not obvious how the coins should be sorted. You could 
sort them by their names, or by their values. The Arrays.sort method 
cannot make that decision for you. Instead, it requires that the objects belong to 
classes that implement the Comparable interface. That interface has a single method: 


public interface Comparable 
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int compareTo(Object otherObject) ; 
} 


The call 


a.comparelo(b) 


must return a negative number if a should come before b, 0 if a and b are the same, 
and a positive number otherwise. 

Several classes in the standard Java library, such as the String and Date classes, 
implement the Comparable interface. 

You can implement the Comparable interface for your own classes as well. For 
example, to sort a collection of coins, the Coin class would need to implement this 
interface and define a compareTo method: 


public class Coin implements Comparable 


: 
public int compareTo(Object otherObject) 
{ 
Coin other = (Coin) otherObject; 
if (value < other.value) return -1; 
if (value == other.value) return 0; 
return 1; 
} 
} 


When you implement the compareTo method of the Comparable interface, you must 
make sure that the method defines a total ordering relationship, with the following 
three properties: 


¢ Antisymmetric: If a.compareTo(b) < 0, then b.compareTo(a) 2 0 
© Reflexive: a.compareTo(a) =0 
e Transitive: If a.compareto(b) <0 and b.compareTo(c) < 0, then a.compareTo(c) <0 


Once your Coin class implements the Comparable interface, you can simply pass an 
array of coins to the Arrays.sort method: 


Coin[] coins = new Coin[n]; 


// Add coins 


Arrays.sort(coins) ; 


If the coins are stored in an ArrayList, use the Collections.sort 


The Collections class method instead; it uses the merge sort algorithm: 


contains a sort method 
that can sort array lists. ArrayList<Coin> coins = new ArrayList<Coin>() ; 


// Add coins 


Collections.sort(coins); 


As a practical matter, you should use the sorting and searching methods in the 
Arrays and Collections classes and not those that you write yourself. The library 
algorithms have been fully debugged and optimized. Thus, the primary purpose of 
this chapter was not to teach you how to implement practical sorting and searching 
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algorithms. Instead, you have learned something more important, namely that dif- 
ferent algorithms can vary widely in performance, and that it is worthwhile to learn 
more about the design and analysis of algorithms. 


SELF CHECK 


16. Why can’t the Arrays.sort method sort an array of Rectangle objects? 


17. What steps would you need to take to sort an array of BankAccount objects by 
increasing balance? 


COMMON ERROR 14.1 
The compareTo Method Can Return Any Integer, Not Just -1, 0, and 1 


The call a.compareTo(b) is allowed to return any negative integer to denote that a should 
come before b, not necessarily the value —1. That is, the test 


if (a.compareTo(b) == -1) // ERROR! 
is generally wrong. Instead, you should test 
if Ca.compareTo(b) < 0) // OK 


Why would a compareTo method ever want to return a number other than —1, 0, or 1? Some- 
times, it is convenient to just return the difference of two integers. For a apie, the compareTo 
method of the String class compares characters in matching positions: 


char cl = charAt(i); 
char c2 = other.charAtQ) ; 


If the characters are different, then the method simply returns their difference: 
1f (cl != c2) return cl - c2; 


This difference is a negative number if c1 is less than 2, but it is not necessarily the number —1. 


ADVANCED TOPIC 14.4 


The Parameterized Comparable Interface 


As of Java version 5.0, the Comparable interface is a parameterized type, similar to the Array- 
List type: 


public interface Comparable<I> 


{ 


int compareTo(C! other) 


} 


The type parameter specifies the type of the objects that this class is willing to accept for 
comparison. Usually, this type is the same as the class type itself. For example, the Coin class 
would implement Comparable<Coin>, like this: 
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public class Coin implements Comparable<Coin> 


{ 
public int compareTo(Coin other) 
{ 
if (value < other.value) return -1; 
if (value == other.value) return 0; 
return 1; 
} 
} 


The type parameter has a significant advantage: You need not use a cast to convert an Object 
parameter into the desired type. 


ADVANCED Topic 14.5 


The Comparator Interface 


Sometimes, you want so sort an array or array list of objects, but the objects don’t belong to 
a class that implements the Comparable interface. Or, perhaps, you want to sort the array ina 
different order. For example, you may want to sort coins by name rather than by value. 

You wouldn’t want to change the implementation of a class just in order to call 
Arrays.sort. Fortunately, there is an alternative. One version of the Arrays.sort method 
does not require that the objects belong to classes that implement the Comparab1e interface. 
Instead, you can supply arbitrary objects. However, you must also provide a comparator 
object whose job is to compare objects. The comparator object must belong to a class that 
implements the Comparator interface. That interface has a single method, compare, which 
compares two objects. 

As of Java version 5.0, the Comparator interface is a parameterized type. The type parameter 
specifies the type of the compare parameters. For example, Comparator<Coin> looks like this: 


public interface Comparator<Coin> 


{ 
int compare(Coin a, Coin b); 
} 
The call 


comp.compare(a, b) 


must return a negative number if a should come before b, 0 if a and b are the same, and a posi- 
tive number otherwise. (Here, comp is an object of a class that implements Comparator<Coin>.) 
For example, here is a Comparator class for coins: 


public class CoinComparator implements Comparator<Coin> 
{ 
public int compare(Coin a, Coin b) 
{ 
if Ca.getValueQ) < b.getValue()) return -1; 
if (Ca.getValueQ) == b.getValue()) return 0; 
return 1; 
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To sort an array of coins by value, call 


| Arrays.sort(coins, new CoinComparator()); 


1, 


11. 
12. 


13. 


The selection sort algorithm sorts an array by repeatedly finding the smallest 
element of the unsorted tail region and moving it to the front. 


. Computer scientists use the big-Oh notation f(7) = O(g(7)) to express that the 


function f grows no faster than the function g. 


. Selection sort is an O(n’) algorithm. Doubling the data set means a fourfold 


increase in processing time. 


. Insertion sort is an O(n") algorithm. 


. The merge sort algorithm sorts an array by cutting the array in half, recursively 


sorting each half, and then merging the sorted halves. 


. Merge sort is an O(7 log(7)) algorithm. The 7 log(7) function grows much more 


slowly than 7°. 


. The Arrays class implements a sorting method that you should use for your Java 


programs. 


. A linear search examines all values in an array until it finds a match or reaches 


the end. 


. A linear search locates a value in an array in O(7) steps. 


10. 


A binary search locates a value in a sorted array by determining whether the 
value occurs in the first or second half, then repeating the search in one of the 
halves. 


A binary search locates a value in an array in O(log()) steps. 


The sort method of the Arrays class sorts objects of classes that implement the 
Comparable interface. 


The Collections class contains a sort method that can sort array lists. 


1. Michael T. Goodrich and Roberto Tamassia, Data Structures and Algorithms in Java, 3rd 


edition, John Wiley & Sons, 2003. 
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CLASSES, OBJECTS, AND METHODS 
INTRODUCED IN THIS CHAPTER _ 


java. lang. Comparable<T> 
comparelo 
java. lang.System 
currentTimeMillis 
java.util.Arrays 
binarySearch 
sort 
toString 
java.util.Collections 
binarySearch 
sort 
java.uti1.Comparator<T> 
compare 


EXERCISES 


wx Exercise R14.1. Checking against off-by-one errors. When writing the selection sort 
algorithm of Section 14.1, a programmer must make the usual choices of < against 
<=, a. length against a. length - 1, and from against from + 1. This is a fertile ground 
for oft-by-one errors. Conduct code walkthroughs of the algorithm with arrays of 
length 0, 1, 2, and 3 and check carefully that all index values are correct. 


* Exercise R14.2. What is the difference between searching and sorting? 


*&* Exercise R14.3. For the following expressions, what is the order of the growth of each? 
a. n*+2n+1 

.n'° + 9n? + 20n* + 145n” 

(n +1)" 

(ne +nyP 

n+0.001n° 

n> — 1000n? +10” 

. 2 +log(n) 


so moO Qo se 


. n* +n log(n) 
2” +n? 


n? + 2n 
n? + 0.75 


* Exercise R14.4. We determined that the actual number of visits in the selection sort 
algorithm is 


iG n° 0=3 
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We characterized this method as having O(n’) growth. Compute the actual ratios 
T (2,000)/T (1,000) 
T (4,000)/7 (4,000) 
T (10,000)/T (1,000) 


and compare them with 


f (2,000)/f (1,000) 

f (4,000)/f (1,000) 

f (10,000)/ f (1,000) 
where f() = n’. 


* Exercise R14.5. Suppose algorithm A takes 5 seconds to handle a data set of 1,000 
records. If the algorithm A is an O(7) algorithm, how long will it take to handle a 
data set of 2,000 records? Of 10,000 records? 


*&* Exercise R14.6. Suppose an algorithm takes 5 seconds to handle a data set of 1,000 
records. Fill in the following table, which shows the approximate growth of the 
execution times depending on the complexity of the algorithm. 


O(n) O(n?) O(n*) O(nilog(n)) 0(2") 


1,000 5 5 3 5 5 
2,000 

3,000 45 

10,000 


For example, because 3,000 ; 1,000* = 9, the algorithm would take 9 times as long, 
or 45 seconds, to handle a data set of 3,000 records. 


*&* Exercise R14.7. Sort the following growth rates from slowest to fastest growth. 


O(n) O(n log(7)) 
O(n?) O}") 
O(n”) O(Vn) 
O(log(7)) O(nVn) 
O(n? log(n)) O(n'o8")) 


* Exercise R14.8. What is the growth rate of the standard algorithm to find the mini- 
mum value of an array? Of finding both the minimum and the maximum? 
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* Exercise R14.9. What is the growth rate of the following method? 


public static int count(Cint[] a, int c) 


mt count = 0: 
for Cint 1 = 0; 1 < a. length; i++) 
if Cali] == c) count++; 

ee count; 


*&* Exercise R14.10. Your task is to remove all duplicates from an array. For example, if 
the array has the values 


471149511735 
then the array should be changed to 
471195 3 


Here 1s a simple algorithm. Look at a[i]. Count how many times it occurs in a. If 
the count is larger than 1, remove it. What is the growth rate of the time required 
for this algorithm? 


*&* Exercise R14.11. Consider the following algorithm to remove all duplicates from an 
array. Sort the array. For each element in the array, look at its next neighbor to 
decide whether it is present more than once. If so, remove it. Is this a faster algo- 
rithm than the one in Exercise R14.10? 


www Exercise R14.12. Develop an O(7 log (7)) algorithm for removing duplicates from an 
array if the resulting array must have the same ordering as the original array. 


wwe Exercise R14.13. Why does insertion sort perform significantly better than selection 
sort if an array is already sorted? 


wkewew Exercise R14.14. Consider the following speedup of the insertion sort algorithm of 
Advanced Topic 14.1. For each element, use the enhanced binary search algorithm 
that yields the insertion position for missing elements. Does this speedup have a sig- 
nificant impact on the efficiency of the algorithm? 


(ore Additional review exercises are available in WileyPLUS. 
WILEY 


PROGRAMMING EXERCISES 


* Exercise P14.1. Modify the selection sort algorithm to sort an array of integers in 
descending order. 


* Exercise P14.2. Modify the selection sort algorithm to sort an array of coins by their 
value. 
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Exercise P14.3. Write a program that generates the table of sample runs of the selec- 
tion sort times automatically. The program should ask for the smallest and largest 
value of n and the number of measurements and then make all sample runs. 


Exercise P14.4. Modify the merge sort algorithm to sort an array of strings in lexico- 
graphic order. 


Exercise P14.5. Write a telephone lookup program. Read a data set of 1,000 names 
and telephone numbers from a file that contains the numbers in random order. 
Handle lookups by name and also reverse lookups by phone number. Use a binary 
search tor both lookups. 


Exercise P14.6. Implement a program that measures the performance of the insertion 
sort algorithm described in Advanced Topic 14.1. 


Exercise P14.7, Write a program that sorts an ArrayList<Coin> in decreasing order so 
that the most valuable coin is at the beginning of the array. Use a Comparator. 


Exercise P14.8. Consider the binary search algorithm in Section 14.7. If no match is 
found, the search method returns —1. Modify the method so that if a is not found, 

the method returns —k — 1, where k is the position before which the element should 
be inserted. (This is the same behavior as Arrays. binarySearch.) 


Exercise P14.9. Implement the sort method of the merge sort algorithm without 
recursion, where the length of the array is a power of 2. First merge adjacent regions 
of size 1, then adjacent regions of size 2, then adjacent regions of size 4, and so on. 


Exercise P14.10. Implement the sort method of the merge sort algorithm without 
recursion, where the length of the array is an arbitrary number. Keep merging 
adjacent regions whose size is a power of 2, and pay special attention to the last 
area whose size is less. 


Exercise P14.11. Use insertion sort and the binary search from Exercise P14.8 to sort 
an array as described in Exercise R14.14. Implement this algorithm and measure its 
performance. 


Exercise P14.12. Supply a class Person that implements the Comparable interface. 
Compare persons by their names. Ask the user to input 10 names and generate 10 
Person objects. Using the compareTo method, determine the first and last person 
among them and print them. 


Exercise P14.13. Sort an array list of strings by increasing length. Hint: Supply a 
Comparator. 


Exercise P14.14. Sort an array list of strings by increasing length, and so that strings 
of the same length are sorted lexicographically. Hint: Supply a Comparator. 


Additional programming exercises are available in WileyPLUS. 
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PROGRAMMING PROJECTS 


Project 14.1. Write a program that keeps an appointment book. Make a class 
Appointment that stores a description of the appointment, the appointment day, the 
starting time, and the ending time. Your program should keep the appointments in a 
sorted array list. Users can add appointments and print out all appointments for a 
given day. When a new appointment is added, use binary search to find where it 
should be inserted in the array list. Do not add it if it conflicts with another 
appointment. 


Project 14.2. Implement a graphical animation of sorting and searching algorithms. 
Fill an array with a set of random numbers between 1 and 100. Draw each array ele- 
ment as a bar, as in Figure 3. Whenever the algorithm changes the array, wait for the 
user to click a button, then call the repaint method. 


Animate selection sort, merge sort, and binary search. In the binary search anima- 
tion, highlight the currently inspected element and the current values of from and to. 


Figure 3 
Graphical Animation 


664 CHAPTER 14 # Sorting and Searching 


ANSWERS TO SELF-CHECK QUESTIONS 


4 


—y A OF & WD DN 


16. 
17. 


Dropping the temp variable would not work. Then afi] and a[j] would end up 
being the same value. 


~1(54326,12)4356,123456 

. Four times as long as 40,000 values, or about 50 seconds. 
. A parabola. 

. It takes about 100 times longer. 

. If mis 4, then sn is 8and 2n —3is7. 


. When the preceding while loop ends, the loop condition must be false, that 1s, 


iFirst >= first. length or iSecond >= second. length (De Morgan’s Law). Then 
first. length - iFirst <= 0 or iSecond. length - iSecond <= 0. 


. First sort 8 7 6 5. Recursively, first sort 8 7. Recursively, first sort 8. It’s sorted. 


Sort 7. It’s sorted. Merge them: 7 8. Do the same with 6 5 to get 5 6. Merge them 
to 567 8. Do the same with 4 3 2 1: Sort 4 3 by sorting 4 and 3 and merging 
them to 3 4. Sort 2 1 by sorting 2 and 1 and merging them to 1 2. Merge 3 4 and 
12to 1234. Finally, merge 5678 and1234to12345678. 


. Approximately 100,000 - log(100,000) / 50,000 - log(50,000) = 2-5 / 4.7 = 2.13 


times the time required for 50,000 values. That’s 2.13 - 97 milliseconds or 
approximately 207 milliseconds. 


« By calling Arrays.sort(values). 
. On average, you’d make 500,000 comparisons. 


. The search method returns the index at which the match occurs, not the data 


stored at that location. 


. You would search about 20. (The binary log of 1,024 is 10.) 


. Then you know where to insert it so that the array stays sorted, and you can 


keep using binary search. 


. Otherwise, you would not know whether a value is present when the method 


returns 0. 
The Rectangle class does not implement the Comparable interface. 


The BankAccount class needs to implement the Comparable interface. Its 
compareTo method must compare the bank balances. 


Chapter | 


An Introduction to 
Data Structures 


To learn how to use the linked lists provided in the 
standard library | 


To be able to use iterators to traverse linked lists 

To understand the implementation of linked lists 

To distinguish between abstract and concrete data types 
To know the efficiency of fundamental operations of lists 
and arrays 


To become familiar with the stack and queue types 


Up to this point, we used arrays as a one-size-fits-all mechanism for collecting 
objects. However, computer scientists have developed many different data 
structures that have varying performance tradeoffs. In this chapter, you will learn 
about the linked list, a data structure that allows you to add and remove elements 
efficiently, without moving any existing elements. You will also learn about the 
distinction between concrete and abstract data types. An abstract type spells out 
what fundamental operations should be supported efficiently, but it leaves the 
implementation unspecified. The stack and queue types, introduced at the end of 


this chapter, are examples of abstract types. 
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A linked list is a data structure used for collecting a sequence of objects, which 
allows efficient addition and removal of elements in the middle of the sequence. 

To understand the need for such a data structure, imagine a program that main- 
tains a sequence of employee objects, sorted by the last names of the employees. 
When a new employee is hired, an object needs to be inserted into the sequence. 
Unless the company happened to hire employees in dictionary order, the new 
object probably needs to be inserted somewhere near the middle of the sequence. If 
we use an array to store the objects, then all objects following the new hire must be 
moved toward the end. 

Conversely, if an employee leaves the company, the object must be removed, and 
the hole in the sequence needs to be closed up by moving all objects that come after 
it. Moving a large number of values can involve a substantial amount of processing 
time. We would like to structure the data in a way that minimizes this cost. 

Rather than storing the values in an array, a linked list uses a 
sequence of nodes. Each node stores a value and a reference to the 
next node in the sequence (see Figure 1). When you insert a new 
node into a linked list, only the neighboring node references need to 
be updated. The same is true when you remove a node. What’s the 
catch? Linked lists allow speedy insertion and removal, but element 
access can be slow. 

For example, suppose you want to locate the fifth element. You 
must first traverse the first four. This is a problem if you need to 
access the elements in arbitrary order. The term “random access” is 
used in computer science to describe an access pattern in which ele- 
ments are accessed in arbitrary (not necessarily random) order. In 
contrast, sequential access visits the elements in sequence. For exam- 
ple, a binary search requires random access, whereas a linear search 
requires sequential access. 

OF course, if you mostly visit all elements in sequence (for example, to display or 
print the elements), the inefficiency of random access is not a problem. You use 
linked lists when you are concerned about the efficiency of inserting or removing 
elements and you rarely need element access in random order. 
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Figure 1 Inserting an Element into a Linked List 


The Java library provides a linked list class. In this section you will learn how to 
use the library class. In the next section you will peek under the hood and see how 
some of its key methods are implemented. 

The LinkedList class in the java.util package is a generic class, just like the 
ArrayList class. That is, you specify the type of the list elements in angle brackets, 
such as LinkedList<String> or LinkedList<Product>. 

The following methods give you direct access to the first and the last element in 
the list. Here, E is the element type of LinkedList<E>. 


void addFirst(E element) 
void addLast(E element) 
E getFirst(Q) 

E getLast() 

E removeFirstQ 

E removeLast() 


How do you add and remove elements in the middle of the list? The list will not 
give you references to the nodes. If you had direct access to them and somehow 
messed them up, you would break the linked list. As you will see in 
the next section, where you implement some of the linked list oper- 
ations yourself, keeping all links between nodes intact is not trivial. 
Instead, the Java library supplies a ListIterator type. A list iterator 
encapsulates a position anywhere inside the linked list (see Figure 2). 


Figure 2 A List Iterator 


668 


CHAPTER 15 #® An Introduction to Data Structures 


Initial ListIterator position D H R qT 


After calling next D H R T 


After inserting J D J H R 7 


Figure 3 A Conceptual View of the List Iterator 


Conceptually, you should think of the iterator as pointing between two ele- 
ments, just as the cursor in a word processor points between two characters (see 
Figure 3). In the conceptual view, think of each element as being like a letter in a 
word processor, and think of the iterator as being like the blinking cursor between 
letters. 

You obtain a list iterator with the 1istIterator method of the LinkedList class: 


LinkedList<String> employeeNames = . - 
ListIterator<String> iterator = employeeNames.listIterator(); 


Note that the iterator class is also a generic type. A ListIterator<String> iterates 
through a list of strings; a ListIterator<Product> visits the elements in a 
LinkedList<Product>. 

Initially, the iterator points before the first element. You can move the iterator 
position with the next method: 


jiterator.next(); 


The next method throws a NoSuchElementException if you are already past the end of 
the list. You should always call the method hasNext before calling next —it returns 
true if there is a next element. 


if Citerator.hasNext()) 
iterator.nextQ); 


The next method returns the element that the iterator is passing. When you use a 
ListIterator<String>, the return type of the next method is String. In general, the 
return type of the next method matches the type parameter. 

You traverse all elements in a linked list of strings with the following loop: 


while (iterator.hasNext()) 
{ 


String name = iterator.next(); 
Do something with name 


} 


As a shorthand, if your loop simply visits all elements of the linked list, you can use 
the “for each” loop: 
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for (String name : employeeNames) 


Do something with name 


} 


Then you don’t have to worry about iterators at all. Behind the scenes, the for loop 
uses an iterator to visit all list elements (see Advanced Topic 15.1). 

The nodes of the LinkedList class store two links: one to the next element and 
one to the previous one. Such a list is called a doubly linked list. You can use the 
previous and hasPrevious methods of the ListIterator interface to move the iterator 
position backwards. 

The add method adds an object after the iterator, then moves the iterator position 
past the new element. 


iterator.add("Juliet"); 


You can visualize insertion to be like typing text in a word processor. Each charac- 
ter is inserted after the cursor, and then the cursor moves past the inserted character 
(see Figure 3). Most people never pay much attention to this—you may want to try 
it out and watch carefully how your word processor inserts characters. 

The remove method removes the object that was returned by the last call to next 
or previous. For example, the following loop removes all names that fulfill a certain 
condition: 


while Citerator.hasNext() ) 


{ 
String name = iterator.nextQ); 
if (name fulfills condition) 
iterator.remove() ; 
} 


You have to be careful when calling remove. It can be called only once after calling 
next or previous, and you cannot call it immediately after a call to add. If you call 
the method improperly, it throws an I1legalStateException. 

Here is a sample program that inserts strings into a list and then iterates through 
the list, adding and removing elements. Finally, the entire list is printed. The com- 
ments indicate the iterator position. 


ch15/uselist/ListTester.java 


1 import java.util.LinkedList; 
import java.util.ListIterator; 


z 

3 

4 /* * 

: A program that tests the LinkedList class. 
* / 

7 

8 


public class ListTester 


{ 
9 public static void main(String[] args) 
10 { 
ll LinkedList<String> staff = new LinkedList<String>Q ; 
12 Statt.addLast(’ Dick"); 


13 staff. addlast( Harry’); 
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14 staff.addLast(''Romeo"); 

15 staff.addLast('"Tom"); 

16 

17 // | inthe comments indicates the iterator position 
18 

19 ListIterator<String> iterator 

20 = staff.listIterator(); // |DHRT 

21 iterator.nextQ); // D|HRT 

22 iterator.nextQ); // DH|RT 

23 

24 // Add more elements after second element 

25 

26 iterator.add("Juliet"); // DHJ|RT 

27 iterator.add("Nina"); // DHIN|RT 

28 

29 iterator.nextQ); // DHINR|T 

30 

31 // Remove last traversed element 

32 

33 iterator.remove(); // DHIN|T 

34 

35 // Print all elements 

36 

3/7 for (String name : staff) 

38 System.out.print(iterator.next() +" "); 
39 System.out.printIn(); 

40 System.out.printInC"Expected: Dick Harry Juliet Nina Tom"); 
41 } 

42 } 

Output 


Dick Harry Juliet Nina Tom 
Expected: Dick Harry Juliet Nina Tom 


SELF CHECK 


1. Do linked lists take more storage space than arrays of the same size? 


2. Why don’t we need iterators with arrays? 


ADVANCED Topic 15.1 


The Iterable Interface and the “For Each” Loop 


You can use the “for each” loop 


for (Type variable : collection) 
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with any of the collection classes in the standard Java library. This includes the ArrayList 
and LinkedList classes as well as the library classes which will be discussed in Chapter 16. In 
fact, the “for each” loop can be used with any class that implements the Iterab1e interface: 


public interface Iterable<E> 


{ 


Iterator<E> iterator(); 


: 


The interface has a type parameter E, denoting the element type of the collection. The single 
method, iterator, yields an object that implements the Iterator interface. 


public interface Iterator<E> 


{ 
boolean hasNext(); 
E nextQ(); 
void remove(); 

} 


The ListIterator interface that you saw in the preceding section is a subinterface of 
Iterator with additional methods (such as add and previous). 

The compiler translates a “for each” loop into an equivalent loop that uses an iterator. The 
loop 


for (Type variable : collection) 
body | 


is equivalent to 


Iterator</ype> iter = collection.iterator() ; 
while Citer.hasNext()) 


Type variable = iter.next(Q); 
body 


} 


The ArrayList and LinkedList classes implement the Iterable interface. If your own classes 
implement the Iterable interface, you can use them with the “for each” loop as well—see 
Peercise P15.15, 


plementing | 


In the last section you saw how to use the linked list class supplied by the Java 
library. In this section, we will look at the implementation of a simplified version of 
this class. This shows you how the list operations manipulate the links as the list 1s 
modified. 

To keep this sample code simple, we will not implement all methods of the linked 
list class. We will implement only a singly linked list, and the list class will supply 
direct access only to the first list element, not the last one. Our list will not use a 
type parameter. We will simply store raw Object values and insert casts when 
retrieving them. The result will be a fully functional list class that shows how the 
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links are updated in the add and remove operations and how the iterator traverses the 
list. 

A Node object stores an object and a reference to the next node. Because the 
methods of both the linked list class and the iterator class have frequent access to 
the Node instance variables, we do not make the instance variables private. Instead, 
we make Node a private inner class of the LinkedList class. Because none of the list 
methods returns a Node object, it is safe to leave the instance variables public. 


public class LinkedList 


{ 
private class Node 
{ 
public Object data; 
public Node next; 
} 
} 
The LinkedList class holds a reference first to the first node (or nu71, if the list is 
completely empty). 
public class LinkedList 
: 
public LinkedListQ 
{ 
first = null; 
. 
public Object getFirst(Q) 
if 
if Cfirst == null) 
throw new NoSuchElementException(); 
return first.data; 
} 
private Node first; 
} 


Now let us turn to the addFirst method (see Figure 4). When a new node is added 
to the list, it becomes the head of the list, and the node that was the old list head 
becomes its next node: 


public class LinkedList 


{ 

public void addFirst(Object element) 

{ 
Node newNode = new Node(); Ge 
newNode.data = element; 
newNode.next = first; 2 
first = newNode; 3) 

7 
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newNode = 


Figure 4 Adding a Node to the Head of a Linked List 


Removing the first element of the list works as follows. The data of the first node 
are saved and later returned as the method result. The successor of the first node 
becomes the first node of the shorter list (see Figure 5). Then there are no further 
references to the old node, and the garbage collector will eventually recycle it. 


public class LinkedList 


if 
public Object removeFirst() 
{ 
if (first == null) 
throw new NoSuchElementException() ; 
Object element = first.data; 
first = first.next; &> 
return element; 
; 
} 


Next, let us turn to the iterator class. The ListIterator interface in the standard 
library defines nine methods. We omit four of them (the methods that move the 
iterator backwards and the methods that report an integer index of the iterator). 


Figure 5 Removing the First Node from a Linked List 
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Our LinkedList class defines a private inner class LinkedListIterator, which 
implements the simplified ListIterator interface. Because LinkedListIterator is an 
inner Class, it has access to the private features of the LinkedList class—in particular, 
the first field and the private Node class. 

Note that clients of the LinkedList class don’t actually know the name of the iter- 
ator class. They only know it is a class that implements the ListIterator interface. 


public class LinkedList 


{ 
public ListIterator listIterator() 
{ 
return new LinkedListIterator(); 
} 
private class LinkedListIterator 
implements ListIterator 
{ 
public LinkedListIterator() 
{ 
position = null; 
previous = null; 
} 
private Node position; 
private Node previous; 
} 
hi 


Each iterator object has a reference position to the last visited node. We also store a 
reference to the last node before that. We will need that reference to adjust the links 
properly in the remove method. 

The next method is simple. The position reference is advanced to position.next, 
and the old position is remembered in previous. There is a special case, however —if 
the iterator points before the first element of the list, then the old position is nu11, 
and position must be set to first. 


private class LinkedListIterator 
implements ListIterator 


{ 


public Object next) 
{ 
if C!hasNext(Q)) 
throw new NoSuchElementException() ; 
previous = position; // Remember for remove 


if Cposition == null) 
position = first; 
else 


position = position.next; 


return position.data; 
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} 


The next method is supposed to be called only when the iterator is not yet at the 
end of the list. The iterator is at the end if the list is empty (that 1s, first == null) or 
if there is no element after the current position (position.next == null). 


private class LinkedListIterator 
implements ListIterator 


{ 
public boolean hasNext() 
{ 
if (position == null) 
return first != null; 
else 
return position.next != null; 
} 
} 


Removing the last visited node is more involved. If the element to be 
removed is the first element, we just call removeFirst. Otherwise, an 
element in the middle of the list must be removed, and the node pre- 
ceding it needs to have its next reference updated to skip the removed 
element (see Figure 6). If the previous reference equals position, then 
this call to remove does not immediately follow a call to next, and we 
throw an I1legalStateException. 


Figure 6 Removing a Node from the Middle of a Linked List 
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According to the definition of the remove method, it is illegal to call remove twice 
in a row. Therefore, the remove method sets the previous reference to position. 


private class LinkedListIterator 
implements ListIterator 


{ 


public void remove() 


{ 
if (previous == position) 
throw new IllegalStateException(); 
Tf (position. == Tirst) 
{ 


} 


else 


{ 


} 
position = previous; £3 


removeFirst(); 


previous.next = position.next; 1 


} 


The set method changes the data stored in the previously visited element. Its imple- 
mentation is straightforward because our linked lists can be traversed in only one 
direction. The linked-list implementation of the standard library must keep track of 


= 


v7 newNode = 


Figure 7 Adding a Node to the Middle of a Linked List 
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whether the last iterator movement was forward or backward. For that reason, the 
standard library forbids a call to the set method following an add or remove method. 
We do not enforce that restriction. 


public void set(Object element) 


{ 
if (position == null) 
| throw new NoSuchElementException() ; 
| position.data = element; 
| } 


Finally, the most complex operation is the addition of a node. You insert the new 
node after the current position, and set the successor of the new node to the succes- 
sor of the current position (see Figure 7). 


private class LinkedListIterator 
implements ListIterator 


{ 
public void add(Object element) 
{ 
if (position == null) 
addFirst(element) ; 
position = first; 
} 
else 
{ 
Node newNode = new Node(); 
newNode.data = element; 
newNode.next = position.next; GD 
position.next = newNode; 
position = newNode; 
} 
previous = position; 
, 
} 


At the end of this section is the complete implementation of our LinkedList class. 
You now know how to use the LinkedList class in the Java library, and you have 
had a peek “under the hood” to see how linked lists are implemented. 


ch15/impllist/LinkedList.java 


| 1 import java.util .NoSuchElementException; 
| 2 
| 3 [* cs 
4 A linked list is a sequence of nodes with efficient 
| 5 element insertion and removal. This class 
6 contains a subset of the methods of the standard 
7 java.util.LinkedList class. 
8 « 
9 public class LinkedList 
10 { 
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Constructs an empty linked list. 


¥ i 
public LinkedListQ 


{ 

TIPst = Olt; 

} 

[** . . 
Returns the first element in the linked list. 
@return the first element in the linked list 

aa 

public Object getFirstQ 

1 
1f Cfirst == null) 

throw new NoSuchElementException(); 
return first.data; 

$ 

[** 


Removes the first element in the linked list. 
@return the removed element 


public Object removeFirst() 


if 
if (first == null) 
throw new NoSuchElementException(); 
Object element = first.data; 
first = first.next; 
return element; 
} 
Adds an element to the front of the linked list. 
@param element the element to add 
= 
public void addFirst(Object element) 
{ 
Node newNode = new Node(); 
newNode.data = element; 
newNode.next = first; 
first = newNode; 
} | 
/* . ° . . . . 
Returns an iterator for iterating through this list. 
@return an iterator for iterating through this list 
* / 
public ListIterator listIterator() 
{ | 
return new LinkedListIterator(); 
} 
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Implementing Linked Lists 


private Node first; 
private class Node 


public Object data; 
public Node next; 


} 


private class LinkedListIterator implements ListIterator 


{ 


[er 
Constructs an iterator that points to the front 
of the linked list. 
public LinkedListIterator() 
{ 
position = null; 
previous = null; 
} 


Moves the iterator past the next element. 
@return the traversed element 


% / 
public Object next() 
af 
if ClhasNextQ) 
throw new NoSuchElementException() ; 
previous = position; // Remember for remove 


if (position == null) 
position = first; 

else 
position = position.next; 


return position.data; 


Tests if there is an element after the iterator 

position. 

@return true if there is an element after the iterator 
position 


¥ fg 
public boolean hasNext() 


1 
if (position == null) 
return first != null; 
else 
return position.next != null; 
} 
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116 He 

117 Adds an element before the iterator position 
118 and moves the iterator past the inserted element. 
119 @param element the element to add 

120 * / , 

121 public void add(Object element) 

122 { 

123 if (position == null) 

124 { 

125 addFirst(element) ; 

126 position = first; 

127 } 

128 else 

129 { 

130 Node newNode = new Node(); 

131 newNode.data = element; 

132 newNode.next = position.next; 

133 position.next = newNode; 

134 position = newNode; 

135 } 

136 previous = position; 

137 } 

138 

139 [ue 

140 Removes the last traversed element. This method may 
141 only be called after a call to the next method. 
142 * 

143 public void remove() 

144 f 

145 if (previous == position) 

146 throw new IllegalStateException(); 
147 

148 if (position == first) 

149 { 

150 removeFirst(); 

151 } 

152 else 

153 { 

154 previous.next = position.next; 
155 } 

156 position = previous; 

157 } 

158 

159 [ue 

160 Sets the last traversed element to a different 
161 value. 

162 @param element the element to set 

163 * / 

164 public void set(Object element) 

165 { 

166 if (position == null) 

167 throw new NoSuchElementException(); 
168 position.data = element; 


169 } 


15.2 


170 
171 
172 
173 
174} 
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private Node position; 
private Node previous; 


i 


ch15/impllist/Listlterator.java 


1 vi ws 


{ 


A list iterator allows access to a position in a linked list. 

This interface contains a subset of the methods of the 

standard java.util.ListIterator interface. The methods for 
backward traversal are not included. 


public interface ListIterator 


[** 
Moves the iterator past the next element. 
@return the traversed element 

* / 

Object nextQ; 


[** 
Tests if there is an element after the iterator 
position. 
G@return true if there is an element after the iterator 
position 


boolean hasNext(); 

Adds an element before the iterator position 
and moves the iterator ea the inserted element. 
@param element the element to add 

* / 

void add(Object element); 

[** . 
Removes the last traversed element. This method may 
only be called after a call to the next() method. 

void remove(); 

Sets the last traversed element to a different 
value. 


@param element the element to set 


void set(Object element) ; 
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An abstract datatype — 

_ defines the fundamental 
operations on the data but 
does not specifyan 
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SELF CHECK 


3. ‘Trace through the addFirst method when adding an element to an empty list. 


4. Conceptually, an iterator points between elements (see Figure 3). Does the 
position reference point to the element to the left or to the element to the right? 


5. Why does the add method have two separate cases? 


ADVANCED Topic 15.2 
Static Inner Classes 


You first saw the use of inner classes for event handlers. Inner classes are useful in that con- 
text, because their methods have the privilege of accessing private data members of outer- 
class objects. The same is true for the LinkedListIterator inner class in the sample code for 
this section. The iterator needs to access the first instance variable of its linked list. 

However, the Node inner class has no need to access the outer class. In fact, it has no meth- 
ods. Thus, there is no need to store a reference to the outer list class with each Node object. To 
suppress the outer-class reference, you can declare the inner class as static: 


public class LinkedList 


{ 
private static class Node 
{ 
} 

i: 


The purpose of the keyword static in this context is to indicate that the inner-class objects 
do not depend on the outer-class objects that generate them. In particular, the methods of a 
static inner class cannot access the outer-class instance variables. Declaring the inner class 
statics efficient, because its objects do not store an outer-class reference. 

However, the LinkedListIterator class cannot be a static inner class. It frequently refer- 
ences the first element of the enclosing LinkedList. 
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There are two ways of looking at a linked list. One way is to think of the concrete 
implementation of such a list as a sequence of node objects with links between them 
(see Figure 8). 

On the other hand, you can think of the abstract concept of the 
linked list. In the abstract, a linked list is an ordered sequence of data 
items that can be traversed with an iterator (see Figure 9). 

Similarly, there are two ways of looking at an array list. Of course, 


‘implementation. —-SS—S—S—« array list has a concrete implementation: a partially filled array of 


object references (see Figure 10). But you don’t usually think about 


15.3. # Abstract and Concrete Data Types 683 


Figure 8 A Concrete View of a Linked List 


/ NS ™ 


Figure 9 An Abstract View of a Linked List 


the concrete implementation when using an array list. You take the abstract point 
of view. An array list is an ordered sequence of data items, each of which can be 
accessed by an integer index (see Figure 11). 

The concrete implementations of a linked list and an array list are quite different. 
The abstractions, on the other hand, seem to be similar at first glance. To see the dif- 
ference, consider the public interfaces stripped down to their minimal essentials. 


Figure 10 A Concrete View of an Array List 


rm 


[0] [1] [2] 3] ‘([/4] 


Figure 11. An Abstract View of an Array List 
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An array list allows random access to all elements. You specify an integer index, 
and you can get or set the corresponding element. 


public class ArrayList 


{ 
public Object get(int index) {... } 
public void set(int index, Object element) { ... } 


} 


With a linked list, on the other hand, element access is a bit more complex. A linked 
list allows sequential access. You need to ask the linked list for an iterator. Using 
that iterator, you can easily traverse the list elements one at a time. But if you want 
to go to a particular element, say the 100th one, you first have to skip all elements 
before it. 


public class LinkedList 


z 

public ListIterator listIteratord) {.. . } 
} 
public interface ListIterator 
{ 

Object nextQ); 

boolean hasNext(); 

void add(Object element); 

void remove(); 

void set(Object element); 
} 


Here we show only the fundamental operations on array lists and linked lists. 
Other operations can be composed from these fundamental operations. For exam- 
ple, you can add or remove an element in an array list by moving all elements 
beyond the insertion or removal index, calling get and set multiple times. 

Of course, the ArrayList class has methods to add and remove elements in the 
middle, even if they are slow. Conversely, the LinkedList class has get and set meth- 
ods that let you access any element in the linked list, albeit very inefficiently, by 
performing repeated sequential accesses. 

In fact, the term ArrayList signifies that its implementors wanted to combine the 
interfaces of an array and a list. Somewhat confusingly, both the ArrayList and the 
LinkedList class implement an interface called List that defines operations both for 
random access and for sequential access. 

That terminology is not in common use outside the Java library. Instead, let us 
adopt a more traditional terminology. We will call the abstract types array and Uist. 
The Java library provides concrete implementations ArrayList and LinkedList for 
these abstract types. Other concrete implementations are possible in other libraries. 
In fact, Java arrays are another implementation of the abstract array type. 

To understand an abstract data type completely, you need to know not just its 
fundamental operations but also their relative efficiency. 
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An abstract list is an 
—ordered sequence of items 
that can be traversed 


sequentially and that 


-allows for insertion and 


removal of elements at 
any position. 


An abstract array is an 
ordered sequence of items 


with random access via an 
integer index. 


Table 1 Efficiency of Operations for Arrays and Lists 


Operation Array List 
Random access O(1) O(n) 
Linear traversal step O(1) O(1) 
Add/remove an element O(n) O(1) 


In a linked list, an element can be added or removed in constant 
time (assuming that the iterator is already in the right position). A 


fixed number of node references need to be modified to add or 


remove a node, regardless of the size of the list. Using the big-Oh 
notation, an operation that requires a bounded amount of time, 
regardless of the total number of elements in the structure, is denoted 
as O(1). Random access in an array list also takes O(1) time. 

Adding or removing an arbitrary element in an array takes O(7) 
time, where 7 is the size of the array list, because on average 7/2 ele- 
ments need to be moved. Random access in a linked list takes O(7) 
time because on average 7/2 elements need to be skipped. 

Table 1 shows this information for arrays and lists. 

Why consider abstract types at all? If you implement a particular 
algorithm, you can tell what operations you need to carry out on the 


data structures that your algorithm manipulates. You can then determine the 
abstract type that supports those operations efficiently, without being distracted by 
implementation details. 

For example, suppose you have a sorted collection of items and you want to 
locate items using the binary search algorithm (see Section 14.7). That algorithm 
makes a random access to the middle of the collection, followed by other random 
accesses. Thus, fast random access 1s essential for the algorithm to work correctly. 
Once you know that an array supports fast random access and a linked list does not, 
you then look for concrete implementations of the abstract array type. You won’t 
be fooled into using a LinkedList, even though the LinkedList class actually pro- 
vides get and set methods. 

In the next section, you will see additional examples of abstract data types. 


SELF CHECK 


6. What is the advantage of viewing a type abstractly? 


7. How would you sketch an abstract view of a doubly linked list? A concrete 


view? 


8. How much slower is the binary search algorithm for a linked list compared to 
the linear search algorithm? 
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In this section we will consider two common abstract data types that allow inser- 
tion and removal of items at the ends only, not in the middle. A stack lets you insert 
and remove elements at only one end, traditionally called the top of the stack. To 
visualize a stack, think of a stack of books (see Figure 12). 

New items can be added to the top of the stack. Items are removed 
at the top of the stack as well. Therefore, they are removed in the 
order that 1s opposite from the order in which they have been added, 
called last in, first out or LIFO order. For example, if you add items 
A, B, and C and then remove them, you obtain C, B, and A. Tradition- 
ally, the addition and removal operations are called push and pop. 

A queue is similar to a stack, except that you add items to one end 
of the queue (the tail) and remove them from the other end of the 
queue (the head). To visualize a queue, simply think of people lining 
up (see Figure 13). People join the tail of the queue and wait until they 
have reached the head of the queue. Queues store items in a first in, first out or 
FIFO fashion. Items are removed in the same order in which they have been added. 

There are many uses of queues and stacks in computer science. The Java graphi- 
cal user interface system keeps an event queue of all events, such as mouse and key- 
board events. The events are inserted into the queue whenever the operating system 
notifies the application of the event. Another thread of control removes them from 
the queue and passes them to the appropriate event listeners. Another example is a 
print queue. A printer may be accessed by several applications, perhaps running on 
different computers. If each of the applications tried to access the printer at the 
same time, the printout would be garbled. Instead, each application places all bytes 
that need to be sent to the printer into a file and inserts that file into the print queue. 
When the printer is done printing one file, it retrieves the next one from the queue. 
Therefore, print jobs are printed using the “first j in, first out” rule, which is a fair 
arrangement for users of the shared printer. 


Figure 12 A Stack of Books 
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Figure 13 A Queue 


Stacks are used when a “last in, first out” rule is required. For example, consider 
an algorithm that attempts to find a path through a maze. When the algorithm 
encounters an intersection, it pushes the location on the stack, and then it explores 
the first branch. If that branch is a dead end, it returns to the location at the top of 
the stack. If all branches are dead ends, it pops the location off the stack, revealing a 
previously encountered intersection. Another important example is the run-time 
stack that a processor or virtual machine keeps to organize the variables of nested 
methods. Whenever a new method is called, its parameters and local variables are 
pushed onto a stack. When the method exits, they are popped off again. This stack 
makes recursive method calls possible. 

There is a Stack class in the Java library that implements the abstract stack type 
and the push and pop operations. The following sample code shows how to use that 
class. 


Stack<String> s = new Stack<String>Q ; 

s.push ("A") ; 

s.push("B"); 

s.push("C"); 

// The following loop prints C, B, and A 

while (s.size() > 0) 
System.out.printIn(s.popQ) ; 


The Stack class in the Java library uses an array to implement a stack. Exercise 
P15.11 shows how to use a linked list instead. 
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The implementations of a queue in the standard library are designed for use with 
multithreaded programs. However, it is simple to implement a basic queue yourself: 


public class LinkedListQueue 
{ 
/* * 
Constructs an empty queue that uses a linked list. 


ss 7 
public LinkedListQueue() 


{ 
list = new LinkedListQ; 


} 


Adds an element to the tail of the queue. 
@param element the element to add 


public void add(Object element) 


{ 
list.addLast(Celement) ; 
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Removes an element from the head of the queue. 
@return the removed element 

% / 

public Object remove () 

{ 


sto ole 
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Gets the number of elements in the queue. 
@return the size 

* / 

int size() 


{ 
} 


return list.removeFirst(); 


return list.sizeQ; 


private LinkedList list; 
$ 


You would definitely not want to use an ArrayList to implement a queue. Remov- 
ing the first element of an array list is inefficient—all other elements must be moved 
towards the beginning. However, Exercise P15.12 shows you how to implement a 
queue efficiently as a “circular” array, in which all elements stay at the position at 
which they were inserted, but the index values that denote the head and tail of the 
queue change when elements are added and removed. 

In this chapter, you have seen the two most fundamental abstract data types, 
arrays and lists, and their concrete implementations. You also learned about the 
stack and queue types. In the next chapter, you will see additional data types that 
require more sophisticated implementation techniques. 
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SELF CHECK 


9. Draw a sketch of the abstract queue type, similar to Figures 9 and 11. 
10. Why wouldn’t you want to use a stack to manage print jobs? 


RANDOM FACT 15.1 


Standardization 


You encounter the benefits of standardization every day. When you buy a light bulb, you 
can be assured that it fits the socket without having to measure the socket at home and the 
light bulb in the store. In fact, you may have experienced how painful the lack of standards 
can be if you have ever purchased a flashlight with nonstandard bulbs. Replacement bulbs 
for such a flashlight can be difficult and expensive to obtain. 

Programmers have a similar desire for standardization. Consider the important goal of 
platform independence for Java programs. After you compile a Java program into class files, 
you can execute the class files on any computer that has a Java virtual machine. For this to 
work, the behavior of the virtual machine has to be strictly defined. If virtual machines don’t 
all behave exactly the same way, then the slogan of “write once, run anywhere” turns into 
“write once, debug everywhere”. In order for multiple implementors to create compatible 
virtual machines, the virtual machine needed to be standardized. That is, someone needed to 
create a definition of the virtual machine and its expected behavior. 

Who creates standards? Some of the most successful standards have been created by vol- 
unteer groups such as the Internet Engineering Task Force (IETF) and the World Wide Web 
Consortium (W3C). You can find the Requests for Comment (RFC) that standardize many 
of the Internet protocols at the IETF site, http://ww.ietf.org/rfc.html. For example, 
RFC 822 standardizes the format of e-mail, and RFC 2616 defines the Hypertext Transmis- 
sion Protocol (HTTP) that is used to serve web pages to browsers. The W3C standardizes 
the Hypertext Markup Language (HTML), the format for web pages—see http:// 
www.w3c.org. [hese standards have been instrumental in the creation of the World Wide Web 
as an open platform that is not controlled by any one company. 

Many programming languages, such as C++ and Scheme, have been standardized by inde- 
pendent standards organizations, such as the American National Standards Institute (ANSI) 
and the International Organization for Standardization—called ISO for short (not an acro- 
nym; see http://www.iso.ch/iso/en/aboutiso/introduction/whatisISO.html). ANSI and 
ISO are associations of industry professionals who develop standards for everything from 
car tires and credit card shapes to programming languages. 

The process of standardizing the C++ language turned out to be very painstaking and 
time-consuming, and the standards organization followed a rigorous process to ensure fair- 
ness and to avoid being influenced by companies with vested interests. 

When a company invents a new technology, it has an interest in its invention becoming a 
standard, so that other vendors produce tools that work with the invention and thus increase 
its likelihood of success. On the other hand, by handing over the invention to a standards 
committee, especially one that insists on a fair process, the company may lose control over 
the standard. For that reason, Sun Microsystems, the inventor of Java, never agreed to have a 
third-party organization standardize the Java language. They run their own standardization 
process, involving other companies but refusing to relinquish control. Another unfortunate 
but common tactic is to create a weak standard. For example, Netscape and Microsoft chose 
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the European Computer Manufacturers Association (ECMA) to standardize the JavaScript 
language (see Random Fact 10.1). ECMA was willing to settle for something less than truly 
useful, standardizing the behavior of the core language and just a few of its libraries. Because 
most useful JavaScript programs need to use more libraries than those defined in the stan- 
dard, programmers still go through a lot of tedious trial and error to write JavaScript code 
that runs identically on different browsers. 

Often, competing standards are developed by different coalitions of vendors. For exam- 
ple, at the time of this writing, hardware vendors are in disagreement whether to use the HD 
DVD or Blu-Ray standard for high-density video disks. As Grace Hopper, the famous com- 
puter science pioneer, observed: “The great thing about standards is that there are so many to 
choose from”. 

Of course, many important pieces of technology aren’t standardized at all. Consider the 
Windows operating system. Although Windows is often called a de-facto standard, it really 
is no standard at all. Nobody has ever attempted to define formally what the Windows oper- 
ating system should do. The behavior changes at the whim of its vendor. That suits Microsoft 
just fine, because it makes it impossible for a third party to create its own version of 
Windows. 

As a computer professional, there will be many times in your career when you need to 
make a decision whether to support a particular standard. Consider a simple example. In this 
chapter, we use the LinkedList class from the standard Java library. However, many com- 
puter scientists dislike this class because the interface muddies the distinction between 
abstract lists and arrays, and the iterators are clumsy to use. Should you use the LinkedList 
class in your own code, or should you implement a better list? If you do the former, you 
have to deal with a design that is less than optimal. If you do the latter, other programmers 
may have a hard time understanding your code because they aren’t familiar with your list 
class. 


CHAPTER SUMMARY 


1. A linked list consists of a number of nodes, each of which has a reference to the 
next node. 


2. Adding and removing elements in the middle of a linked list is efficient. 


3. Visiting the elements of a linked list in sequential order is efficient, but random 
access 1s not. 


4. You use a list iterator to access elements inside a linked list. 


5. Implementing operations that modify a linked list is challenging—you need to 
make sure that you update all node references correctly. 


6. An abstract data type defines the fundamental operations on the data but does 
not specify an implementation. 


7. An abstract list is an ordered sequence of items that can be traversed sequentially 
and that allows for insertion and removal of elements at any position. 


Review Exercises 691 


8. An abstract array is an ordered sequence of items with random access via an 
integer index. 


9. A stack is a collection of items with “last in first out” retrieval. 


10. A queue is a collection of items with “first in first out” retrieval. 


CLASSES, OBJECTS, AND METHODS 
INTRODUCED IN THIS CHAPTER 


java.util.Collection<E> java.util. List<E> 
add listIterator 
contains java.util.ListIterator<E> 
iterator add 
remove hasPrevious 
size previous 
java.util.Iterator<E> set 
hasNext 
next 
remove 
java.util.LinkedList<E> 
addFirst 
addLast 
getFirst 
getLast 
removeFirst 
removeLast 


REVIEW EXERCISES 


* Exercise R15.1. Explain what the following code prints. Draw pictures of the linked 
list after each step. Just draw the forward links, as in Figure 1. 


LinkedList<String> staff = new LinkedList<String>(); 
staff.addFirstC"Harry") ; 

staff.addFirstC"Dick"); 

staff.addFirstC"Tom") ; 
System.out.printIn(staff.removeFirstQ)); 
System.out.printIn(staff.removeFirstQ); 
System.out.printIn(staff.removeFirst()); 


* Exercise R15.2. Explain what the following code prints. Draw pictures of the linked 
list after each step. Just draw the forward links, as in Figure 1. 


LinkedList<String> staff = new LinkedList<String>(); 
staff.addFirstC"Harry"); 

staff.addFirstC"Dick") ; 

staff.addFirst ("Tom"); 
System.out.printIn(staff.removeLast()); 
System.out.printIn(staff.removeFirstQ); 
System.out.printIn(staff.removeLast()); 
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Exercise R15.3. Explain what the following code prints. Draw pictures of the linked 
~ list after each step. Just draw the forward links, as in Figure 1. 


LinkedList<String> staff = new LinkedList<String>Q ; 
staff.addFirstC"Harry"); 

staff.addLastC"Dick") ; 

staff.addFirstC'Tom") ; 
System.out.printIn(staff.removeLastQ) ; 
System.out.printIn(staff.removeFirst()); 
System.out.printIn(staff.removeLastQ)) ; 


Exercise R15.4. Explain what the following code prints. Draw pictures of the linked 
list and the iterator position after each step. 


LinkedList<String> staff = new LinkedList<String>() ; 
ListIterator<String> iterator = staff.listIterator(; 
jterator.addC"Tom") ; 
jterator.add("Dick"); 
jterator.addC"Harry") ; 
iterator = staff.listiteratorQ; 
if Citerator.nextQ .equalsC"Tom")) 
jterator.remove(); 
while Citerator.hasNextQ) 
System.out.printInCiterator.nextQ); 


Exercise R15.5. Explain what the following code prints. Draw pictures of the linked 
list and the iterator position after each step. 


LinkedList<String> staff = new LinkedList<String>Q) ; 
ListIterator<String> iterator = staff.listIteratorQ; 


iterator. 
iterator. 
iterator. 


iterator 


iterator. 
iterator. 
iterator. 
iterator. 
iterator. 


iterator 


iterator. 
iterator. 


addC"Tom"); 
add("Dick"); 
addC"Harry'"); 

= staff.listIteratorQ; 
nextQ; 

nextQ); 

add("Romeo") ; 

next); 

addC"Juliet"); 

= staff.listIterator(; 
nextQ; 

remove(); 


while C(iterator.hasNextQ) 
System.out.printInCiterator.next()); 


Exercise R15.6. The linked list class in the Java library supports operations addLast and 
removeLast. To carry out these operations efficiently, the LinkedList class has an 

added reference last to the last node in the linked list. Draw a “before/after” diagram 
of the changes of the links in a linked list under the addLast and removeLast methods. 


Exercise R15.7. The linked list class in the Java library supports bidirectional itera- 
tors. To go backward efficiently, each Node has an added reference, previous, to the 
predecessor node in the linked list. Draw a “before/after” diagram of the changes of 
the links in a linked list under the addFirst and removeFirst methods that shows 
how the previous links need to be updated. 
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Exercise R15.8. What advantages do lists have over arrays? What disadvantages do 
they have? 


Exercise R15.9. Suppose you needed to organize a collection of telephone numbers 
for a company division. There are currently about 6,000 employees, and you know 
that the phone switch can handle at most 10,000 phone numbers. You expect several 
hundred lookups against the collection every day. Would you use an array or a list 
to store the information? 


Exercise R15.10. Suppose you needed to keep a collection of appointments. Would 
you use a list or an array of Appointment objects? 


Exercise R15.11. Suppose you write a program that models a card deck. Cards are 
taken from the top of the deck and given out to players. As cards are returned to the 
deck, they are placed on the bottom of the deck. Would you store the cards in a 
stack or a queue? 


Exercise R15.12. Suppose the strings "A"... "Z" are pushed onto a stack. Then they 
are popped off the stack and pushed onto a second stack. Finally, they are all 
popped off the second stack and printed. In which order are the strings printed? 


Additional review exercises are available in WileyPLUS. 


PROGRAMMING EXERCISES 


Exercise P15.1. Using only the public intertace of the linked list class, write a method 
public static void downsize(LinkedList<String> staff) 


that removes every other employee from a linked list. 


Exercise P15.2, Using only the public interface of the linked list class, write a method 
public static void reverse(LinkedList<String> staff) 


that reverses the entries in a linked list. 


Exercise P15.3. Add a method reverse to our implementation of the LinkedList class 
that reverses the links in a list. Implement this method by directly rerouting the 
links, not by using an iterator. 


Exercise P15.4. Add a method size to our implementation of the LinkedList class 
that computes the number of elements in the list, by following links and counting 
the elements until the end of the list is reached. 


Exercise P15.5. Add a currentSize field to our implementation of the LinkedList 
class. Modity the add and remove methods of both the linked list and the list iterator 
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to update the currentSize field so that it always contains the correct size. Change 
the size method of the preceding exercise so that it simply returns the value of this 
instance variable. 


Exercise P15.6. The linked list class of the standard library has an add method that 
allows efficient insertion at the end of the list. Implement this method for the 
LinkedList class in Section 15.2. Add an instance field to the linked list class that points 
to the last node in the list. Make sure the other mutator methods update that field. 


Exercise P15.7. Repeat Exercise P15.6, but use a different implementation strategy. 
Remove the reference to the first node in the LinkedList class, and make the next 
reference of the last node point to the first node, so that all nodes form a cycle. Such 
an implementation is called a circular linked list. 


Exercise P15.8. Reimplement the LinkedList class of Section 15.2 so that the Node and 
LinkedListIterator classes are not inner classes. 


Exercise P15.9. Add a previous field to the Node class in Section 15.2, and supply 
previous and hasPrevious methods in the iterator. 


Exercise P15.10. The standard Java library implements a Stack class, but in this exer- 
cise you are asked to provide your own implementation. Do not implement type 
parameters. Use an Object[] array to hold the stack elements. When the array fills 
up, allocate an array of twice the size and copy the values to the larger array. 


Exercise P15.11. Implement a Stack class by using a linked list to store the elements. 
Do not implement type parameters. 


Exercise P15.12. Implement a queue as a circular array as follows: Use two index 
variables head and tail that contain the index of the next element to be removed and 
the next element to be added. After an element is removed or added, the index is 
incremented (see Figure 14). 


After a while, the tail element will reach the top of the array. Then it “wraps 
around” and starts again at O—see Figure 15. For that reason, the array 1s called 
“circular”. 


public class CircularArrayQueue 
{ 
public CircularArrayQueue(int capacity) { .. . } 
public void add(Object x) { . . 
public Object remove() { .. . } 
public int size() {.. . } 
private int head; 
private int tail; 
private int theSize; 
private Object[] elements; 


} 


This implementation supplies a bounded queue—it can eventually fill up. See the 
next exercise on how to remove that limitation. 
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4 
head 1 tail 
2 
3 
4 
tail head 1 
2 
3 
Figure 14 Figure 15 
Adding and Removing A Queue That Wraps Around 
Queue Elements the End of the Array 


Exercise P15.13. The queue in Exercise P15.12 can fill up if more elements are added 
than the array can hold. Improve the implementation as follows. When the array 
fills up, allocate a larger array, copy the values to the larger array, and assign it to the 
elements instance variable. Hint: You can’t just copy the elements into the same 
position of the new array. Move the head element to position 0 instead. 


Exercise P15.14. Modify the insertion sort algorithm of Advanced Topic 14.1 to sort 
a linked list. 


Exercise P15.15. Modify the Invoice class of Chapter 12 so that it implements the 
Iterable<LineItem> interface. Then demonstrate how an Invoice object can be used 
in a “for each” loop. 


Exercise P15.16. Write a program to display a linked list graphically. Draw each ele- 
ment of the list as a box, and indicate the links with line segments. Draw an iterator 
as in Figure 3. Supply buttons to move the iterator and to add and remove elements. 


Additional programming exercises are available in WileyPLUS. 


PROGRAMMING PROJECTS 


Project 15.1. Implement a class Polynomial that describes a polynomial such as 
Dix) = 5x19 +.9x7 — x -10 


Store a polynomial as a linked list of terms. A term contains the coefficient and the 
power of x. For example, you would store p(x) as 


(5, 10), (9, 7), (—1, 1), (—10, 0) 


Supply methods to add, multiply, and print polynomials, and to compute the deriv- 
ative of a polynomial. 
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Project 15.2. Make the list implementation of this chapter as powerful as the imple- 
mentation of the Java library. (Do not implement type parameters, though.) 


e Provide bidirectional iteration. 
© Make Node a static inner class. 


© Implement the standard List and ListIterator interfaces and provide the 
missing methods. (Jip: You may find it easier to extend AbstractList instead 
of implementing all List methods from scratch.) 


Project 15.3. Implement the following algorithm for the evaluation of arithmetic 
expressions. 


Each operator has a precedence. The + and - operators have the lowest precedence, * 
and / have a higher (and equal) precedence, and 4 (which denotes “raising to a 
power” in this exercise) has the highest. For example, 


3* 4A2Q2+4+ 5 
should mean the same as 
(3 * (4A 2)) +5 


with a value of 53. 


In your algorithm, use two stacks. One stack holds numbers, the other holds opera- 


tors. When you encounter a number, push it on the number stack. When you 
encounter an operator, push it on the operator stack if it has higher precedence than 
the operator on the top of the stack. Otherwise, pop an operator off the operator 
stack, pop two numbers off the number stack, and push the result of the computa- 
tion on the number stack. Repeat until the top of the operator stack has lower pre- 
cedence. At the end of the expression, clear the stack in the same way. For example, 
here is how the expression 3 * 4 4 2 + 5 is evaluated: 


Exoression: 3° ° 4 4 2 °#55 


(a) Remaining expression. *4A24+5 Number stack Operator stack 
é) 

2) Remaining expression: 4A2+5 Number stack Operator stack 
3 * 

& Remaining expression: A 2 +5 Number stack Operator stack 
4 
3 

CD Remaining expression: 245 Number stack Operator stack 
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You should enhance this algorithm to deal with parentheses. Also, make sure 
that subtractions and divisions are carried out in the correct order. For example, 
12 - 5 - 3 should yield 4. | 


ANSWERS TO SELF-CHECK QUESTIONS 


1. Yes, for two reasons. You need to store the node references, and each node is a 
separate object. (There is a fixed overhead to store each object in the virtual 
machine.) 


2. An integer index can be used to access any array location. 


3. When the list is empty, first is nul]. A new Node is allocated. It’s data field is set 
to the newly inserted object. It’s next field is set to nu11 because first is nul]. 
The first field is set to the new node. The result is a linked list of length 1. 


4. It points to the element to the left. You can see that by tracing out the first call 
to next. It leaves position to point to the first node. 


5. If position is null, we must be at the head of the list, and inserting an element 
requires updating the first reference. If we are in the middle of the list, the 
first reference should not be changed. 


6. You can focus on the essential characteristics of the data type without being 
distracted by implementation details. 


7. The abstract view would be like Figure 9, but with arrows in both directions. 
The concrete view would be like Figure 8, but with references to the previous 
node added to each node. 
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8. To locate the midde element takes 7 / 2 steps. To locate the middle of the sub- 


10. 


interval to the left or right takes another 7 / 4 steps. The next lookup takes 7 / 8 
steps. Thus, we expect almost 7 steps to locate an element. At this point, you 
are better off just making a linear search that, on average, takes 1 / 2 steps. 


| 


remove 


~«—— add 


Stacks use a “last in, first out” discipline. If you are the first one to submit a 
print job and lots of people add print jobs before the printer has a chance to 
deal with your job, they get their printouts first, and you have to wait until all 
other jobs are completed. 
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Data Structures 


To learn about the set and map data types 

To understand the implementation of hash tables 

To be able to program hash functions 

To learn about binary trees 

To be able to use tree sets and tree maps 

To become familiar with the heap data structure 

To learn how to implement the priority queue data type 


To understand how to use heaps for sorting 


ln this chapter we study data structures that are more complex than arrays or lists. 
These data structures take control of organizing their elements, rather than keeping 
them in a fixed position. In return, they can offer better performance for adding, 
removing, and finding elements. 

You will learn about the abstract set and map data types and the implemen- 
tations that the standard library offers for these abstract types. You will see how 
two completely different implementations—hash tables and trees—can be used to 


implement these abstract types efficiently. 


700 CHAPTER 16 = Advanced Data Structures 


CHAPTER CONTENTS 


16.1 Sets 700 16.6 Tree Traversal 731 
QUALITY TIP 16.1: Use Interface References to RANDOM FACT 16.1: Reverse Polish Notation 734 


Manipulate Data Struct 704 
anipulate Data Structures 70 16.7 Using Tree Sets and Tree Maps 735 


16.2 Maps 705 How To 16.1: Choosing a Container 737 


RANDOM FACT 16.2: Soft Pi 738 
16.3 Hash Tables 707 AND ormware riracy 


16.4 Computing Hash Codes 715 16-8 Priority Queues 739 


COMMON ERROR 16.1: Forgetting to 16.9 Heaps 740 


Define hashCode 719 
Ie asic os 16.10 The Heapsort Algorithm 751 


16.5 Binary Search Trees 720 


In the preceding chapter you encountered two important data structures: arrays and 
lists. Both have one characteristic in common: These data structures keep the ele- 
ments in the same order in which you inserted them. However, in many applica- 
tions, you don’t really care about the order of the elements in a collection. For 
example, a server may keep a collection of objects representing available printers 
(see Figure 1). The order of the objects doesn’t ante matter. 


Figure 1 A Set of Printers 
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In mathematics, such an unordered collection is called a set. You have 
probably learned some set theory in a course in mathematics, and 
you may know that sets are a fundamental mathematical notion. 

But what does that mean for data structures? If the data structure 
is no longer responsible for remembering the order of element inser- 
tion, can it give us better performance for some of its operations? It 
turns out that it can indeed, as you will see later in this chapter. 


Let’s list the fundamental operations on a set: 


e Adding an element 


e Removing an element 


| e Containment testing (does the set contain a given object?) 


“Sets don’ t have duplicates. 
Adding a duplicate of. an 
element. that i is already 
“Present is silently ignored. 


Listing all elements (in arbitrary order) 


In mathematics, a set rejects duplicates. If an object is already in the 
set, an attempt to add it again is ignored. That’s useful in many pro- 
- ging situations as well. For example, if we keep a set of avail- 
able printers, each printer should occur at most once in the set. Thus, 
we will interpret the add and remove operations of sets just as we do 


in wat nemiates Adding an element has no effect if the element is already in the set, 
and attempting to remove an element that isn’t in the set is silently ignored. 

Of course, we could use a linked list to implement a set. But adding, removing, 
and containment testing would be relatively slow, because they all have to do a lin- 
ear search through the list. (Adding requires a search through the list to make sure 
that we don’t add a duplicate.) As you will see later in this chapter, there are data 
structures that can handle these operations much more quickly. 


The HashSet and TreeSet 


: classes both implement | 
othe. Set interface. 


Figure 2 


Set Classes and Interfaces in the 


In fact, there are two different data structures for this purpose, 
called hash tables and trees. The standard Java library provides set 
implementations based on both data structures, called HashSet and 
TreeSet. Both of these data structures implement the Set interface 
(see Figure 2). 
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You will see later in this chapter when it is better to choose a hash set over a tree 
set. For now, let’s look at an example where we choose a hash set. To keep the exam- 
ple simple, we’ll store only strings, not Printer objects. 


Set<String> names = new HashSet<String>Q ; 


Note that we store the reference to the HashSet<String> object in a Set<String> vari- 
able. After you construct the collection object, the implementation no longer mat- 
ters; only the interface is important. 

Adding and removing set elements is straightforward: 


names.addC("Romeo") ; 
names.removeC("Juliet"); 


The contains method tests whether an element is contained in the set: 
if Cnames.contains("Juliet")) 


Finally, to list all elements in the set, get an iterator. As with list itera- 
tors, you use the next and hasNext methods to step through the set. 


Iterator<String> iter = names.iteratorQ( ; 
while Citer.hasNext()) 
{ 


String name = iter.nextQ; 
Do something with name 


} 


Or, as with arrays and lists, you can use the “for each” loop instead of explicitly 
using an iterator: 


for (String name : names) 


Do something with name 
} 
Note that the elements are not visited in the order in which you 
inserted them. Instead, they are visited in the order in which the 


order in which you ~—_—sHashSet keeps them for rapid execution of its methods. 

inserted them. The set There is an important difference between the Iterator that you 
implementationrearranges obtain from a set and the ListIterator that a list yields. The List- 
the elements sothatitcan Iterator has an add method to add an element at the list iterator posi- 
locate them quickly. = tion. The Iterator interface has no such method. It makes no sense 


You cannot add an 
element to a set at an 


to add an element at a particular position in a set, because the set can 
order the elements any way it likes. Thus, you always add elements 
directly to a set, never to an iterator of the set. 


iterator position. However, you can remove a set element at an iterator position, 


just as you do with list iterators. 

Also, the Iterator interface has no previous method to go backwards through 
the elements. Becausé the elements are not ordered, it is not meaningful to distin- 
guish between “going forward” and “going backward”. 

The following test program allows you to add and remove set elements. After 
each command, it prints out the current contents of the set. When you run this pro- 
gram, try adding strings that are already contained in the set and removing strings 
that aren’t present in the set. 
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ch16/set/SetDemo.java 


import java.util.HashSet; 
import java.util.Scanner; 
import java.util.Set; 


Vix ve 
This program demonstrates a set of strings. The user 
can add and remove strings. 


ale 
a 


public class SetDemo 


public static void main(String[] args) 


4 
Set<String> names = new HashSet<String>Q; 
Scanner in = new Scanner(System.in); 
boolean done = false; 
while (€!done) 
{ 
System.out.printC"Add name, Q when done: "); 
String Input = tn.nextd) : 
if Cinput.equalsIgnoreCase("Q")) 
done = true; 
else 
1 
names.add(input) ; 
printCnames) ; 
j 
; 
done = false; 
while C!done) 
if 
System.out.print("Remove name, Q when done: "); 
String inbUt-=-1henext© > 
if Cinput.equalsIgnoreCase("Q")) 
done = true; 
else 
{ 
names. remove(input) ; 
print(names) ; 
5 
} 
} 
Vika 
Prints the contents of a set of strings. 
@param s a set of strings 
a 
private static void print(Set<String> s) 
{ 


System.out.printC"{ "); 
for (String element : s) 
{ 
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54 System.out.printCelement) ; 
55 System.out.print(" "); 
56 } 
57 System.out.printIn("}"); 
58 : 
59 3} 
Output 

Add name, Q when done: Dick 

{ Dick } 

Add name, Q when done: Tom 

{ Tom Dick } 


Add name, Q when done: Harry 

{ Harry Tom Dick } 

Add name, Q when done: Tom 

{ Harry Tom Dick } 

Add name, Q when done: Q 

Remove name, Q when done: Tom 

{ Harry Dick } 

Remove name, Q when done: Jerry 
{ Harry Dick } 

Remove name, Q when done: Q 


SELF CHECK 


1, Arrays and lists remember the order in which you added elements; sets do not. 
Why would you want to use a set instead of an array or list? 


2. Why are set iterators different from list iterators? 


QUALITY TIP 16.1 


Use Interface References to Manipulate Data Structures 


It is considered good style to store a reference to a HashSet or TreeSet in a variable of type 
>éet. 


Set<String> names = new HashSet<String>Q ; 


This way, you have to change only one line if you decide to use a TreeSet instead. 
Also, methods that operate on sets should specify parameters of type Set: 


public static void print(Set<String> s) 


Then the method can be used for all set implementations. 

In theory, we should make the same recommendation for linked lists, namely to save 
LinkedList references in variables of type List. However, in the Java library, the List inter- 
face is common to both the ArrayList and the LinkedList class. In particular, it has get and 
set methods for random access, even though these methods are very inefficient for linked 
lists. You can’t write efficient code if you don’t know whether random access is efficient or 
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not. This is plainly a serious design error in the standard library, and I cannot recommend 
using the List interface for that reason. (To see just how embarrassing that error is, have a 
look at the source code for the binarySearch method of the Collections class. That method 
takes a List parameter, but binary search makes no sense for a linked list. The code then 
clumsily tries to discover whether the list is a linked list, and then switches to a linear 
search!) 

The Set interface and the Map interface, which you will see in the next section, are well- 
designed, and you should use them. 
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ecco a aseo cations A map is a data type that keeps associations between keys and values. 
between kay and value. Figure 3 gives a typical example: a map that associates names with 
epee «SCOllors. This map might describe the favorite colors of various people. 
Bese ee Mathematically speaking, a map is a function from one set, the key 
set, to another set, the value set. Every key in the map has a unique 
value, but a value may be associated with several keys. 
The HichMapand treeMap Just as there are two kinds of set implementations, the Java library 
cleo botninplement has two implementations for maps: HashMap and TreeMap. Both of them 
the Map interface. __ implement the Map interface (see Figure 4). 
, : After constructing a HashMap or TreeMap, you should store the ref- 
erence to the map object in a Map reference: 


Map<String, Color> favoriteColors = new HashMap<String, Color>(); 


Keys Values 


—— 
me 
a 
be 


Romeo 


Adam 


Eve 


Juliet \ 


Figure 3. AMap 
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«interface» 


Map). 
eee ioila sasha Pe eee eT : 
tL aft 
Scag | HashMap ; - ‘TreeMap 


Map Classes and Interfaces in 
the Standard Library 


Use the put method to add an association: 
favoriteColors.putC"Juliet", Color.PINK); 

You can change the value of an existing association, simply by calling put again: 
favoriteColors.putC"Juliet", Color.RED); 

The get method returns the value associated with a key. 
Color julietsFavoriteColor = favoriteColors.get("Juliet"); 


If you ask for a key that isn’t associated with any values, then the get method 
returns null. 
To remove a key and its associated value, use the remove method: 


favoriteColors.remove("Juliet"); 


Sometimes you want to enumerate all keys in a map. The keySet 


Tet find all keys and values” 
method yields the set of keys. You can then ask the key set for an 


Paap a map, iterate then 


the key set andfindthe _—siterator and get all keys. From each key, you can find the associated 
values that correspond to value with the get method. Thus, the following instructions print all 
the keys. eee ee key/value pairs in a map m: 


Set<String> keySet = m.keySetQ; 
for (String key : keySet) 
f 

Color value = m.get(key); 


System.out.printInCkey + "->" + value); 


} 


The following sample program shows a map in action. 


ch16/map/MapDemo.java 


import java.awt.Color; 
import java.util.HashMap; 
import java.util.Map; 
import java.util.Set; 


WT fe W NO pt 


16.3 = Hash Tables 707 


6 7 * 
7 This program demonstrates a map that maps names to colors. 
8 w 
9 public class MapDemo 
10 { 
ll public static void main(String[] args) 
12 { 
13 Map<String, Color> favoriteColors 
14 = new HashMap<String, Color>Q; 
15 favoriteColors.putC’ Juliet", Color.PINK) ; 
16 favoriteColors.put("Romeo", Color.GREEN) ; 
17 favoriteColors.put("Adam", Color.BLUE); 
18 favoriteColors.put("Eve", Color.PINK); 
19 
20 Set<String> keySet = favoriteColors.keySetQ ; 
21 for (String key : keySet) 
22 1 
23 Color value = favoriteColors.get(key) ; 
24 System.out.printIn(key + "->" + value); 
25 } 
26 } 
27 } 
Output 


Romeo->java.awt.Color[r=0,g=255,b=0] 
Eve->java.awt.Color[r=255,g=175,b=175] 
Adam->java.awt.Color[r=0,g=0,b=255] 
Juliet->java.awt.Color[r=255,g=175,b=175] 


SELF CHECK 


3. What is the difference between a set and a map? 


4. Why is the collection of the keys of a map a set? 


In this section, you will see how the technique of hashing can be used to find ele- 
ments in a data structure quickly, without making a linear search through all 
elements. Hashing gives rise to the hash table, which can be used to implement sets 
and maps. 

were A hash function is a function that computes an integer value, the 
hash code, from an object, in such a way that different objects are 
likely to yield different hash codes. The Object class has a hashCode 
method that other classes need to redefine. The call 


int h = x.hashCodeQ); 
computes the hash code of the object x. 
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A good hash function 
minimizes collisions— 
identical hash codes for 
different objects. 
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Table 1 Sample Strings and 
Their Hash Codes 


String Hash Code 
"Adam" 2035631 
"Eve" 70068 
"Harry" 69496448 
"Jim" 74478 
"Joe" 74656 
"Juliet" —2065036585 
"Katherine" 2079199209 
"Sue" 83491 


It is possible for two or more distinct objects to have the same 
hash code; this is called a collision. A good hash function minimizes 
collisions. For example, the String class defines a hash function for 
strings that does a good job of producing different integer values for 
different strings. Table 1 shows some examples of strings and their 


hash codes. You will see in Section 16.4 how these values are obtained. 
Section 16.4 explains how you should redefine the hashCode method for other 


classes. 


A hash code is used as an array index into a hash table. In the simplest implemen- 
tation of a hash table, you could make an array and insert each object at the location 
of its hash code (see Figure 5). 


[70068] Eve 


[74478] Jim 


[74656] Joe 


Figure 5 
A Simplistic Implementation 
of a Hash Table 
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Then it is a very simple matter to find out whether an object is already present in 
the set or not. Compute its hash code and check whether the array position with that 
hash code is already occupied. This doesn’t require a search through the entire array! 

However, there are two problems with this simplistic approach. First, it is not 
possible to allocate an array that is large enough to hold all possible integer index 
positions. Therefore, we must pick an array of some reasonable size and then 
reduce the hash code to fall inside the array: 


int h = x.hashCodeQ) ; 

if (h < 0) h = -h; 

h=h % size; 
Furthermore, it is possible that two different objects have the same hash code. After 
reducing the hash code modulo a smaller array size, it becomes even more likely 
that several objects will collide and need to share a position in the array. 

enrcsieay To store multiple objects in the same array position, use short node 

sequences for the elements with the same hash code (see Figure 6). 
These node sequences are called buckets. 

Now the algorithm for finding an object x in a hash table 1s quite 
simple. 


1. Compute the hash code and reduce it modulo the table size. 
This gives an index h into the hash table. 


2. Iterate through the elements of the bucket at position h. For 
each element of the bucket, check whether it is equal to x. 


3. If a match is found among the elements of that bucket, then x is 
in the set. Otherwise, it 1s not. 


[65] 
[66] 
[67] 
[68] 
[69] 
[70] 
[71] 
[72] 
[73] 
[74] 
[75] 
[76] 
[77] 
[78] 
[79] 


Figure 6 A Hash Table with Buckets to Store Elements with the Same Hash Code 
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In the best case, in which there are no collisions, all buckets either are 
empty or have a single element. Then checking for containment takes 
constant or O(1) time. 

More generally, for this algorithm to be effective, the bucket sizes 
must be small. If the table length is small, then collisions are unavoid- 
able, and each bucket will get quite full. Then the linear search through 
a bucket is time-consuming. In the worst case, where all elements end 
up in the same bucket, a hash table degenerates into a linked list! 

In order to reduce the chance for collisions, you should make a hash 
table somewhat larger than the number of elements that you expect to 
insert. An excess capacity of about 30 percent is typically recom- 
mended. According to some researchers, the hash table size should 


be chosen to be a prime number to minimize the number of collisions. 

Adding an element is a simple extension of the algorithm for finding an object. 
First compute the hash code to locate the bucket in which the element should be 
inserted. Try finding the object in that bucket. If it is already present, do nothing. 
Otherwise, insert it. 

Removing an element is equally simple. First compute the hash code to locate the 
bucket in which the element should be inserted. Try finding the object in that 
bucket. If it is present, remove it. Otherwise, do nothing. 

As long as there are few collisions, an element can also be added or removed in 
constant or O(1) time. 

At the end of this section you will find the code for a simple implementation of a 
hash set. That implementation takes advantage of the AbstractSet class, which 
already implements most of the methods of the Set interface. 

In this implementation you must specify the size of the hash table. In the stan- 
dard library, you don’t need to supply a table size. If the hash table gets too full, a 
new table of twice the size is created, and all elements are inserted into the new table. 


ch16/hashtable/HashSet.java 


1 import java.util.AbstractSet; 
2 import java.util.Iterator: 
3 import java.util.NoSuchElementException; 
4 
5 [** 
6 A hash set stores an unordered collection of objects, using 
7 a hash table. 
8 + 
9 public class HashSet extends AbstractSet 
10 { 
Ll [Re 
12 Constructs a hash table. 
13 @param bucketsLength the length of the buckets array 
14 * / 
15 public HashSet(int bucketsLength) 
16 { 
17 buckets = new Node[bucketsLength] ; 


18 size = 0; 


16.3 


19 
20 
21 
22 
23 
24 
25 
26 


Hash Tables 


Tests for set membership. 


@param x an object 
@return true if x is an element of this set 


public boolean contains(Object x) 


{ 


int h = x.hashCodeQ) ; 
1T Ch: = 0) b= -h: 
h =h % buckets. length; 


Node current = buckets[h]; 
while Ccurrent != null) 


{ 


if Ccurrent.data.equals(x)) return true; 


current = current.next; 


} 


return false; 


Adds an element to this set. 


@param x an object 
@return true if x is a new object, false if x was 
already in the set 


* 7 
public boolean add(Object x) 


{ 


int h = x.hashCode(); 

if ch < 0) h = -h; 

h = h % buckets. length; 
Node current = buckets[h]; 
while Ccurrent != null) 

: 


if Ccurrent.data.equals(x)) 
return false; // Already in the set 
Current = current.next; 


} 

Node newNode = new Node(); 
newNode.data = x; 
newNode.next = buckets[h] ; 


buckets[h] = newNode; 
S1zZe++; 
return true; 


Removes an object from this set. 


@param x an object 
@return true if x was removed from this set, false 
if x was not an element of this set 
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74 public boolean remove(Object x) 

75 f 

76 int h = x.hashCode(); 

77 if (h < 0) h = -h: 

78 h = h % buckets. length; 

79 

80 Node current = buckets[h]; 

81 Node previous = null; 

82 whi le (current != null) 

83 f 

84 if (current.data.equals(x)) 
85 f 

86 1f (previous == null) buckets[h] = current.next: 
87 else previous.next = current.next; 
88 S1ize--; 

89 return true; 

90 } 

91 previous = current; 

92 Current = current.next: 

93 

94 return false; 

95 } 

96 

97 Via 

98 Returns an iterator that traverses the elements of this set. 
99 @return a hash set iterator 

100 * / 

101 public Iterator iterator() 

102 { 

103 return new HashSetIterator(); 
104 } 

105 

106 ete 

107 Gets the number of elements in this set. 
108 @return the number of elements 

109 * / 

110 public int size() 

111 : 

112 return size; 

113 } 

114 

115 private Node[] buckets; 

116 private int size; 

117 

118 private class Node 

119 

120 public Object data; 

121 public Node next; 

122 } 

123 

124 private class HashSetIterator implements Iterator 
125 f 

126 [ex 

127 Constructs a hash set iterator that points to the 


128 first element of the hash set. 
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129 * / 

130 public HashSetIteratorQ 

131 { 

132 current = null; 

133 bucket = -1; 

134 previous = null; 

135 previousBucket = -1; 

136 } 

137 

138 public boolean hasNext() 

139 { 

140 if (current != null && current.next != null) 
141 return true; 

142 for (int b = bucket + 1; b < buckets.length; b++) 
143 if (buckets[b] != null) return true; 
144 return false; 

145 } 

146 

147 public Object nextQ 

148 { 

149 previous = current; 

150 previousBucket = bucket; 

151 if (current == null || current.next == null) 
152 { 

153 // Move to next bucket 

154 bucket++; 

155 

156 while (bucket < buckets. length 

157 && buckets[bucket] == null) 
158 bucket++; 

159 if (bucket < buckets. length) 

160 current = buckets[bucket] ; 

161 else 

162 throw new NoSuchElementException() ; 
163 

164 else // Move to next element in bucket 

165 current = current.next; 

166 return current.data; 

167 $ 

168 

169 public void remove() 

170 { 

171 if (previous != null && previous.next == current) 
172 previous.next = current.next; 

173 else if (previousBucket < bucket) 

174 buckets[bucket] = current.next; 

175 else 

176 throw new IllegalStateExceptionQ; 
177 current = previous; 

178 bucket = previousBucket; 

179 } 

180 

181 private int bucket; 


182 private Node current; 
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183 
184 
185 
186} 


private int previousBucket; 
private Node previous; 


ch16/hashtable/HashSetDemo.java 


1 import 
2 import 
3 

4 y) Ws 4 

5 Thi 

6 */ 

7 public 

8 { 

9 pub 
10 { 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 } 
32 } 
Output 

Harry 
Sue 

Nina 
Susannah 
Larry 
Eve 
Sarah 
Adam 
Juliet 
Katherin 


Tony 


java.util.Iterator; 
java.util.Set; 


s program demonstrates the hash set class. 
class HashSetDemo 
lic static void main(String[] args) 
Set names = new HashSet(101); // 101 isa prime 


names.add("Sue"); 
names.add("Harry'"); 
names.add("Nina"); 
names.addC"Susannah"); 
names.addC"Larry'"); 
names.addC"Eve"); 
names.add("Sarah"); 
names.addC"Adam") ; 
names.addC"Tony"); 
names.addC("Katherine"); 
names.add("Juliet"); 
names.addC"Romeo"); 
names.remove("'Romeo"); 
names.remove("George"); 


Iterator iter = names.iterator(); 


while Citer.hasNext()) 
System.out.printIn(iter.nextQ); 


e 
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SELF CHECK 


5. Ifa hash function returns 0 for all values, will the HashSet work correctly? 


6. What does the hasNext method of the HashSetIterator do when it has reached 
the end of a bucket? 


A hash function computes an integer hash code from an object, so that different 
objects are likely to have different hash codes. Let us first look at how you can com- 
pute a hash code from a string. Clearly, you need to combine the character values of 
the string to yield some integer. You could, for example, add up the character values: 
int h = 0; 
for Cint i = 0; i < s.lengthQ); i++) 
h = h + s.charAt(Q1); 
However, that would not be a good idea. It doesn’t scramble the character values 
enough. Strings that are permutations of another (such as "eat" and "tea") all have 
the same hash code. 
Here is the method the standard library uses to compute the hash code for a string. 
final int HASH_MULTIPLIER = 31; 
int h = 0; 
for Cint 1 = 0; 1-< SitengthQ; 14+) 
h = HASH_MULTIPLIER * h + s.charAt(i); 
For example, the hash code of "eat" 1s 
31 * (31 * 'e' + ‘a') + ‘t’ = 100184 
The hash code of "tea" is quite different, namely 
31 * (31 * 't' + 'e') + ‘a’ = 114704 


(Use the Unicode table from Appendix B to look up the character values: 'a' 1s 97, 
Ne Is 101, and" t" 15 1165) 
ee ee For your own classes, you should make up a hash code that com- 
bines the hash codes of the instance fields in a similar way. For exam- 
ple, let us define a hashCode method for the Coin class. There are two 
instance fields: the coin name and the coin value. First, compute their 
~ hash code. You know how to compute the hash code of a string. To 
compute the hash code of a floating-point number, first wrap the floating-point 
number into a Double object, and then compute its hash code. 


class Coin 
{ 
public int hashCode() 
‘a 
int hl = name.hashCode(); 
int h2 new Double(value).hashCode() ; 
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} 
Then combine the two hash codes. 


final int HASH MULTIPLIER = 29; 

int h = HASH_MULTIPLIER * hl + h2; 

return h; 
Use a prime number as the hash multiplier —it scrambles the values better. 

If you have more than two instance fields, then combine their hash codes as 
follows: 

int h = HASH_MULTIPLIER * hl + h2; 

h = HASH_MULTIPLIER * h + h3; 

h = HASH_MULTIPLIER * h + hé4; 


perunn h; 
If one of the instance fields is an integer, just use the field value as its hash code. 
When you add objects of your class into a hash table, you need to 


Your hashCode method — double-check that the hashCode method is compatible with the equals 


must be compatible with 


method of your class. Two objects that are equal must yield the same 


the equals method. hash code 


e Ifx.equals(y), then x.hashCode() == y.hashCode() 


After all, if x and y are equal to each other, then you don’t want to insert both of 
them into a set—sets don’t store duplicates. But if their hash codes are different, x 
and y may end up in different buckets, and the add method would never notice that 
they are actually duplicates. 

Of course, the converse of the compatibility condition is generally not true. It is 
possible for two objects to have the same hash code without being equal. 

For the Coin class, the compatibility condition holds. We define two coins to be 
equal to each other if their names and values are equal. In that case, their hash codes 
will also be equal, because the hash code is computed from the hash codes of the 
name and value fields. 

You get into trouble if your class defines an equals method but not a hashCode 
method. Suppose we forget to define a hashCode method for the Coin class. Then it 
inherits the hash code method from the Object superclass. That method computes a 
hash code from the memory location of the object. The effect is that any two objects 
are very likely to have a different hash code. 


Coin coinl = new Coin(O0.25, "quarter"); 
Coin coin2 = new Coin(O0.25, "quarter"); 


Now coinl.hashCode() is derived from the memory location of coin1, and 
coin2.hashCode() is derived from the memory location of coin2. Even though 
coinl.equals(coin2) is true, their hash codes differ. 

However, if you define neither equals nor hashCode, then there is no problem. 
The equals method of the Object class considers two objects equal only if their 
memory location is the same. That is, the Object class has compatible equals and 
hashCode methods. Of course, then the notion of equality is very restricted: Only 


16.4 ® Computing Hash Codes 717 


identical objects are considered equal. That is not necessarily a bad notion of equal- 
ity: If you want to collect a set of coins in a purse, you may not want to lump coins 
of equal value together. 

Whenever you use a hash set, you need to make sure that an appropriate hash 
function exists for the type of the objects that you add to the set. Check the equals 
method of your class. It tells you when two objects are considered equal. There are 
two possibilities. Either equals has been defined or it has not been defined. If equals 
has not been defined, only identical objects are considered equal. In that case, don’t 
define hashCode either. However, if the equals method has been defined, look at its 
implementation. Typically, two objects are considered equal if some or all of the 
instance fields are equal. Sometimes, not all instance fields are used in the compari- 
son. Two Student objects may be considered equal if their studentID fields are equal. 
Define the hashCode method to combine the hash codes of the fields that are com- 
pa in the equals method. 

When you use a HashMap, only the keys are hashed. They need 
compatible hashCode and equals methods. The values are never 
hashed or compared. The reason is simple—the map only needs to 
find, add, and remove keys quickly. 

What can you do if the objects of your class have equals and hashCode methods 
defined that don’t work for your situation, or if you don’t want to define an appro- 
priate hashCode method? Maybe you can use a TreeSet or TreeMap instead. Trees are 
the subject of the next section. 


| in a ‘has h map, only the | 


ch16/hashcode/Coin.java 


A coin with a monetary value. 


public class Coin 


1 
2 
3 
4 
> { 
6 
7 
8 
9 


[x 

Constructs a coin. 
@param aValue the monetary value of the coin 
@param aName the name of the coin 

10 */ 

1l public Coin(double aValue, String aName) 

12 £ 

13 value = aValue; 

14 name = aName; 

15 } 

16 

17 wet 

18 Gets the coin value. 

19 @return the value 

20 */ 

21 public double getValue() 

22 f 

23 return value: 

24 } 
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26 ks 

27 Gets the coin name. 

28 @return the name 

29 ay 

30 public String getName() 

31 { 

32 return name; 

33 } 

34 

35 public boolean equals(Object otherObject) 
36 { 

37 if CotherObject == null) return false; 
38 if (getClass(Q) != otherObject.getClass()) return false; 
39 Coin other = (Coin) otherObject; 

40 return value == other.value && name.equals(other.name) ; 
41 I 

42 

43 public int hashCode() 

44 { 

45 int hl = name.hashCode(); 

46 int h2 = new Double(value).hashCode() ; 
47 final int HASH MULTIPLIER = 29; 

48 int h = HASH_MULTIPLIER * hl + h2; 

49 return h; 

50 } 

51 

a2 public String toString() 

53 { 

54 return "Coin[value="_+ value + ",name=""+ name + "]": 
55 } 

56 

57 private double value; 

58 private String name; 

59 } 


ch16/hashcode/CoinHashCodePrinter.java 


import java.util.HashSet; 
import java.util.Set; 


1. 1 
[** 


A program that prints hash codes of coins. 
public class CoinHashCodePrinter 


1 

2 

3 

4 

5 

6 

Z 

& { 

9 public static void main(String[] args) 
10 1 
11 Coin coinl = new Coin(0.25, “quarter"); 
az Coin coin2 = new Coin(0.25, "quarter"); 
13 Coin coin3 = new Coin(0.05, “nickel"); 
14 


15 System.out.printiIn("hash code of coinl=" 
16 + coinl.hashCodeQ) ; 
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17 System.out.printinC"hash code of coin2=" 
18 + coin2 -hashCodeO)- 

19 System.out.printInC’hash code of coin3=" 
. + coin3.hashCode()); 

22 Set<Coin> coins = new HashSet<Coin>(): 
23 coins.add(coin1) ; 

24 coins.add(coin2); 

25 coins.add(coin3); 

26 

27 for (Coin c : coins) 

28 System.out.printIn(c); 

29 

30 } 

Output 


hash code of coinl=-1513525892 
hash code of coin2=-1513525892 
hash code of coin3=-1768365211 
Coin[value=0.25,name=quarter] 
Coin[value=0.05,name=nickel ] 


SELF CHECK 


7, What is the hash code of the string "to"? 
8. What is the hash code of new Integer(13)? 


COMMON ERROR 16.1 
Forgetting to Define hashCode 


When putting elements into a hash table, make sure that the hashCode method is defined. (The 
only exception is that you don’t need to define hashCode if equals isn’t defined. In that case, 
distinct objects of your class are considered different, even if they have matching contents.) 

If you forget to implement the hashCode method, then you inherit the hashCode method of 
the Object class. That method computes a hash code of the memory location of the object. 
For example, suppose that you do mot define the hashCode method of the Coin class. Then the 
following code is likely to fail: 


Set<Coin> coins = new HashSet<Coin>(); 

coins.add(new Coin(0.25, “quarter")); 

// The following comparison will probably fail if hashCode not defined 

if (coins.contains(new Coin(0.25, "“quarter")) 
System.out.printInC"The set contains a quarter."); 


The two Coin objects are constructed at different memory locations, so the hashCode method 
of the Object class will probably compute different hash codes for them. (As always with 
hash codes, there is a small chance that the hash codes happen to collide.) Then the contains 
method will inspect the wrong bucket and never find the matching coin. 

The remedy is to define a hashCode method in the Coin class. 
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A set implementation is allowed to rearrange its elements in any way it chooses so 
that it can find elements quickly. Suppose a set implementation sorts its entries. 
Then it can use binary search to locate elements quickly. Binary search takes 
O(log(z)) steps, where 7 is the size of the set. For example, binary search in an array 
of 1,000 elements is able to locate an element in about 10 steps by cutting the size of 
the search interval in half in each step. 

There is just one wrinkle with this idea. We can’t use an array to store the ele- 
ments of a set, because insertion and removal in an array is slow; an O(7) operation. 

In this section we will introduce the simplest of many treelzke data structures 
that computer scientists have invented to overcome that problem. Binary search 
trees allow fast insertion and removal of elements, and they are specially designed 
for fast — 
— A linked list is a one-dimensional data structure. Every node has a 
ee consists of reference to a single successor node. You can imagine that all nodes 


“node ,each of which has are arranged in line. In contrast, a tree is made of nodes that have retf- 
at most two child nodes. erences to multiple nodes, called the child nodes. Because the child 


nodes can also have children, the data structure has a tree-like appear- 
ance. It is traditional to draw the tree upside down, like a family tree or hierarchy 
chart (see Figure 7). In a binary tree, every node has at most two children (called the 
hess and right children); hence the name binary. 
ue Finally, a binary search tree is carefully constructed to have the 
iain important property: 


The data values of all descendants to the left of any node are less 
than the data value stored in that node, and al/ descendants to the 
right have greater data values. 


The tree in Figure 7 has this property. To verity the binary search 
property, you must check each node. Consider the node “Juliet”. All 

escendants to the left have data before “Juliet”. All descendants on 
the right have data after “Juliet”. Move on to “Eve”. There is a single 
descendant to the left, with data “Adam” before “Eve”, and a single descendant to 
the right, with data “Harry” after “Eve”. Check the remaining nodes in the same 
way. 

Figure 8 shows a binary tree that is not a binary search tree. Look carefully —the 
root node passes the test, but its two children do not. 

Let us implement these tree classes. Just as you needed classes for lists and their 
nodes, you need one class for the tree, containing a reference to the root node, and a 
separate class for the nodes. Each node contains two references (to the left and right 
child nodes) and a data field. At the fringes of the tree, one or two of the child refer- 
ences are nul]. The data field has type Comparable, not Object, because you must be 
able to compare the values in a binary search tree in order to place them into the 
correct position. 
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Figure 8 A Binary Tree That Is Not a Binary Search Tree 
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public class BinarySearchTree 


4 
public BinarySearchTree() { .. . } 
public void add(Comparable obj) { .. . } 


private Node root; 


private class Node 


{ 
public void addNode(Node newNode) { .. . } 


public Comparable data; 
public Node left; 
public Node right; 


} 
To insert data into the tree, use the following algorithm: 


e If you encounter a non-null node reference, look at its data value. If the data 
value of that node is larger than the one you want to insert, continue the process 
with the left child. If the existing cata value is smaller, continue the process with 


the right child. 


e If you encounter a null node reference, replace it with the new node. 


Figure 9 
Binary Search Tree 
After Four Insertions 


Figure 10 


Binary Search Tree 
After Five Insertions 
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For example, consider the tree in Figure 9. It is the result of the following 
statements: 


BinarySearchTree tree = new BinarySearchTree(); 
tree.addC"Juliet"); @ 


tree.add("Tom") ; 2) 
tree.add("Dick"); 
tree.add("Harry") ; 4) 


We want to insert a new element Romeo into it. 
tree.add("Romeo") ; @ 


Start with the root, Juliet. Romeo comes after Juliet, so you move to the right 
subtree. You encounter the node Tom. Romeo comes before Tom, so you move to the 
left subtree. But there is no left subtree. Hence, you insert a new Romeo node as the 
left child of Tom (see Figure 10). 

You should convince yourself that the resulting tree is still a binary search tree. 
When Romeo is inserted, it must end up as a right descendant of Juliet —that is what 
the binary search tree condition means for the root node Juliet. The root node 
doesn’t care where in the right subtree the new node ends up. Moving along to Tom, 
the right child of Juliet, all it cares about is that the new node Romeo ends up some- 
where on its left. There is nothing to its left, so Romeo becomes the new left child, 
and the resulting tree is again a binary search tree. 
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Here is the code for the add method of the BinarySearchtTree class: 


public class BinarySearchTree 


{ 
public void add(Comparable obj) 
{ 
Node newNode = new Node(); 
newNode.data = obj; 
newNode. left = null; 
newNode.right = null; 
if Croot == null) root = newNode; 
else root.addNode(newNode) ; 
} 
} 


If the tree is empty, simply set its root to the new node. Otherwise, you know that 
the new node must be inserted somewhere within the nodes, and you can ask the 
root node to perform the insertion. That node object calls the addNode method of 
the Node class, which checks whether the new object is less than the object stored in 
the node. If so, the element is inserted in the left subtree; if not, it is inserted in the 
right subtree: 


private class Node 


{ 


public void addNode(Node newNode) 
{ 


int comp = newNode.data.comparelo(data) ; 
if Ccomp < 0) 
{ 


if Cleft == null) left = newNode; 
else left.addNode(newNode) ; 


else if Ccomp > 0) 


if Cright == null) right = newNode; 
else right.addNode(newNode) ; 
} 


} 


Let us trace the calls to addNode when inserting Romeo into the tree in Figure 9. The 
first call to addNode 1s 


root.addNode (newNode) 


Because root points to Juliet, you compare Juliet with Romeo and find that you 
must call 


root. right.addNode (newNode) 


The node root.right is Tom. Compare the data values again (Tom vs. Romeo) and find 
that you must now move to the left. Since root.right.left is null, set 
root. right. left to newNode, and the insertion is complete (see Figure 10). 
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Unlike a linked list or an array, and like a hash table, a binary tree has no insert 
positions. You cannot select the position where you would like to insert an element 
into a binary search tree. The data structure is self-organizing; that is, each element 
finds its own place. 

We will now discuss the removal algorithm. Our task is to remove a node from 
the tree. Of course, we must first find the node to be removed. That is a simple mat- 
ter, due to the characteristic property of a binary search tree. Compare the data 
value to be removed with the data value that is stored in the root node. If it is 
smaller, keep looking in the left subtree. Otherwise, keep looking in the right 
subtree. 

Let us now assume that we have located the node that needs to be removed. First, 
let us consider an easy case, when that node has only one child (see Figure 11). 

To remove the node, simply modity the parent link that points to 
the node so that it points to the child instead. 

If the node to be removed has no children at all, then the parent 
link is simply set to nu11. 

The case in which the node to be removed has two children is 
more challenging. Rather than removing the node, it is easier to 
replace its data value with the next larger value in the tree. That 
replacement preserves the binary search tree property. (Alternatively, 
ildren froma: YOu could use the largest element of the left subtree—see Exercise 
ee P'16.16). 
itwith the smallest node -—‘Lo locate the next larger value, go to the right subtree and find its 
of the right subtre smallest data value. Keep following the left child links. Once you reach 
a node that has no left child, you have found the node containing the 
smallest data value of the subtree. Now remove that node—it is eas- 
ily removed because it has at most one child to the right. Then store its data value in 
the original node that was slated tor removal. Figure 12 shows the details. You will 
find the complete code at the end of this section. 


: Node to be removed 


, 4 
\ 
Reroute ; / 


link 


Figure 11. Removing a Node with One Child 
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Smallest child in Reroute 
right subtree link 
Figure 12 Removing a Node with Two Children 
At the end of this section, you will find the source code for the BinarySearchTree 
class. It contains the add and remove methods that we just described, as well as a find 
method that tests whether a value is present in a binary search tree, and a print 
method that we will analyze in the following section. 
—_ Now that you have seen the implementation of this complex data 
Ifa binary search tree is structure, you may well wonder whether it is any good. Like nodes 
balanced, then adding an ina list, nodes are allocated one at a time. No existing elements need 
oe takes clea to be moved when a new element is inserted in the tree; that is an 
time. : Sie sere eerie 


advantage. How fast insertion is, however, depends on the shape of 

the tree. If the tree is balanced —that is, if each node has approximately 
as many descendants on the left as on the right—then insertion is very fast, because 
about half of the nodes are eliminated in each step. On the other hand, if the tree 
happens to be unbalanced, then insertion can be slow—perhaps as slow as insertion 
into a linked list. (See Figure 13.) 

If new elements are fairly random, the resulting tree is likely to be well balanced. 
However, if the incoming elements happen to be in sorted order already, then the 
resulting tree is completely unbalanced. Each new element is inserted at the end, 
and the entire tree must be traversed every time to find that end! 

Binary search trees work well for random data, but if you suspect that the data in 
your application might be sorted or have long runs of sorted data, you should not 
use a binary search tree. There are more sophisticated tree structures whose methods 
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Figure 13° An Unbalanced Binary Search Tree 


keep trees balanced at all times. In these tree structures, one can guarantee that find- 
ing, adding, and removing elements takes O(log(z)) time. To learn more about those 
advanced data structures, you may want to enroll in a course about data structures. 

The standard Java library uses red-black trees, a special form of balanced binary 
trees, to implement sets and maps. You will see in Section 16.7 what you need to do 
to use the TreeSet and TreeMap classes. For information on how to implement a red- 
black tree yourself, see [1]. 


ch16/tree/BinarySearchTree.java 


1 /% % 

2 This class implements a binary search tree whose 

3 nodes hold objects that implement the Comparable 
4 interface. 

2) 

6 public class BinarySearchTree 

7 


{ 
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8 as 
9 Constructs an empty tree. 
10 = 
11 public BinarySearchTree() 
12 
13 root = null; 
14 } 
15 
16 Jes 
17 Inserts a new node into the tree. 
18 @param obj the object to insert 
19 =, 
20 public void add(Comparable obj) 
21 1 
22 Node newNode = new Node(); 
23 newNode.data = obj; 
24 newNode. left = null; 
25 newNode. right = null; 
26 if (root == null) root = newNode; 
ai else root.addNode(newNode) ; 
28 } 
29 
30.0 / 
31 ‘Tries to find an object in the tree. 
32 @param obj the object to find 
+ @return true if the object is contained in the tree 
4 my; 
35 public boolean find(Comparable obj) 
36 { 
37 Node current = root; 
38 while (current != null) 
39 
40 int d = current.data.comparelo(ob}) ; 
41 if (d == 9) return true; 
42 else if (d > ©) current = current. left; 
43 else Current = current.right; 
44 } 
45 return false; 
46 } 
47 
48 f 
49 ‘Tries to remove an object from the tree. Does nothing 
50 if the object is not contained in the tree. | 
a5 @param obj the object to remove 
*]f 
53 public void remove(Comparable obj) 
54 
: 2 // Find node to be removed 
57 Node toBeRemoved = root; 
58 Node parent = null; 
59 boolean found = false; 
60 while (! found && toBeRemoved != nul11) 


61 _ 2 
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62 
63 


Binary Search Trees 


int d = toBeRemoved.data.compareTo(obj); 

if Cd == 0) found = true; 

else 

{ 
parent = toBeRemoved; 
if (d > ©) toBeRemoved = toBeRemoved. left; 
else toBeRemoved = toBeRemoved. right; 


} 


if (!found) return; 

// toBeRemoved contains obj 

// If one of the children is empty, use the other 

if (toBeRemoved.left == null || toBeRemoved.right 


Node newChi ld; 
if (toBeRemoved.left == null) 
newChild = toBeRemoved. right; 
else 
newChild = toBeRemoved. left; 


if (parent == null) // Found in root 
root = newChi ld; 

else if (parent. left == toBeRemoved) 
parent. left = newChild; 

else 
parent.right = newChild; 

return; 


} 
// Neither subtree is empty 
// Find smallest element of the right subtree 


Node smal lestParent = toBeRemoved; 
Node smallest = toBeRemoved. right; 
while Csmallest. left != null) 

{ 


smallestParent = smallest; 
smallest = smallest. left; 


} 
// smallest contains smallest child in right subtree 
// Move contents, unlink child 


toBeRemoved.data = smallest.data:; 
smallestParent.left = smallest.right; 


null) 
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115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 3} 


Prints the contents of the tree in sorted order. 


public void print(Q) 


{ 
if Croot != null) 
root.printNodes() ; 
System.out.printIn(); 
} 


private Node root; 


A node of a tree stores a data item and references 
to the child nodes to the left and to the right. 
*/ 
private class Node 
{ 
/* ve 
Inserts a new node as a descendant of this node. 
@param newNode the node to insert 


% / 
public void addNode(Node newNode) 
i 


int comp = newNode.data.compareTo(data) ; 
if Ccomp < 0) 
{ 


if Cleft == null) left = newNode; 
else left.addNode(newNode) ; 


} 
if Ccomp > 0) 
if Cright == null) right = newNode; 


else right.addNode(newNode) ; 
} 


Prints this node and all of its descendants 
in sorted order. 


vs 7 
public void printNodes() 


{ 
if Cleft != null) 
left.printNodes() ; 
System.out.printIn(data + " "); 
if Cright != null) 
right.printNodes() ; 
} 


public Comparable data; 
public Node left; 
public Node right; 
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SELF CHECK 


9. What is the difference between a tree, a binary tree, and a balanced binary tree? 


10. Give an example of a string that, when inserted into the tree of Figure 10, 
becomes a right child of Romeo. 


Now that the data are inserted in the tree, what can you do with them? It turns out 
to be surprisingly simple to print all elements in sorted order. You know that all 
data in the left subtree of any node must come before the node and before all data in 
the right subtree. That is, the following algorithm will print the elements in sorted 
order: 

1. Print the left subtree. 

2. Print the data. 


3. Print the right subtree. 
Let’s try this out with the tree in Figure 10. The algorithm tells us to 


1. Print the left subtree of Juliet; that 1s, Dick and descendants. 
2. Print Juliet. 
3. Print the right subtree of Juliet; that is, Tom and descendants. 


How do you print the subtree starting at Dick? 


1. Print the left subtree of Dick. There is nothing to print. 
2. Print Dick. 
3. Print the right subtree of Dick, that is, Harry. 


That is, the left subtree of Juliet is printed as 


Dick Harry 


The right subtree of Juliet is the subtree starting at Tom. How is it printed? Again, 
using the same algorithm: 


4. Print the left subtree of Tom, that is, Romeo. 

2. Print Tom. 

3. Print the right subtree of Tom. There is nothing to print. 
Thus, the right subtree of Juliet is printed as 


Romeo Tom 
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Now put it all together: the left subtree, Juliet, and the right subtree: 
Dick Harry Juliet Romeo Tom 


The tree is printed in sorted order. 
Let us implement the print method. You need a worker method printNodes of 
the Node class: 


private class Node 


i 
public void printNodes() 
{ 
if Cleft != null) 
left.printNodesQ) ; 
System.out.print(data +" "); 
ir Cright f= null) 
right.printNodes(); 
} 
} 


To print the entire tree, start this recursive printing process at the root, with the fol- 
lowing method of the Bi narySearchtTree class. 


public class BinarySearchTree 


{ 
public void print) 
{ 
if Croot != null) 
root.printNodes() ; 
System.out.printInQ ; 
} 


This visitation scheme is called inorder traversal. There are two other 
traversal schemes, called preorder traversal and postorder traversal. 
In preorder traversal, 


Tree traversal schemes 
include preorder traversal, 
inorder traversal, and 


postorder traversal. e Visit the root 
e Visit the left subtree 
e Visit the right subtree 


In postorder traversal, 


e Visit the left subtree 
e Visit the right subtree 
e Visit the root 


These two visitation schemes will not print the tree in sorted order. However, they 
are important in other applications of binary trees. Here is an example. 
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In Chapter 13, we presented an algorithm for parsing arithmetic expressions such 


aS 


Figure 14 Expression Trees 


(3 +4) * 5 
See ae, 


It is customary to draw these expressions in tree form—see Figure 14. If all opera- 
tors have two arguments, then the resulting tree is a binary tree. Its leaves store 


numbers, and its interior nodes store operators. 
Note that the expression trees describe the order in which the operators are 


applied. 


This order becomes visible when applying the postorder traversal of the expres- 
sion tree. The first tree yields 


34 4 5 * 


whereas the second tree yields 


345 * 


Postorder traversal ofan 
expression tree yields the | | 
instructions for evaluating — 
the expression on a stack- | 

_ based calculator. : 


You can interpret these sequences as instructions for a stack-based 
calculator. A number means: 


e Push the number on the stack. 
An operator means: 


© Pop the top two numbers off the stack. 
e Apply the operator to these two numbers. 


e Push the result back on the stack. 


Figure 15 shows the computation sequences for the two expressions. 
This observation yields an algorithm for evaluating arithmetic expressions. First, 
turn the expression into a tree. Then carry out a postorder traversal of the 
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5 
3 3 L 7 35 
3 4 + bo) 
5 
4 4 20 
Figure 15 3 3 3 3 23 
A Stack-Based Calculator 3 4 5 * rm 


expression tree and apply the operations in the given order. The result is the value of 
the expression. 
SELF CHECK 


11. What are the inorder traversals of the two trees in Figure 14? 
12. Are the trees in Figure 14 binary search trees? 


RANDOM FACT 16.1 


Reverse Polish Notation 


In the 1920s, the Polish mathematician Jan Lukasiewicz realized that it is possible to dis- 
pense with parentheses in arithmetic expressions, provided that you write the operators 
before their arguments. For example, 


Standard Notation Lukasiewicz Notation 


3 +4 + 3 4 

34+4%* 5 +3. * 4 5 
3 * (4 4+ 5) *3+45 
(3-424) * 5 *+4345 
3 +445 ++345 


The Lukasiewicz notation might look strange to you, but that is just an accident of history. 
Had earlier mathematicians realized its advantages, schoolchildren today would not learn an 
inferior notation with arbitrary precedence rules and parentheses. 

Of course, an entrenched notation is not easily displaced, even when it has distinct disad- 
vantages, and Lukasiewicz’s discovery did not cause much of a stir for about 50 years. 

However, in 1972, Hewlett-Packard introduced the HP 35 calculator that used reverse 
Polish notation or RPN. RPN is simply Lukasiewicz’s notation in reverse, with the opera- 
tors after their arguments. For example, to compute 3 + 4 * 5, youenter3 4 5 * +.RPN 
calculators have no keys labeled with parentheses or an equals symbol. There is just a key 
labeled ENTER to push a number onto a stack. For that reason, Hewlett-Packard’s marketing 
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department used to refer to their product as “the calculators that have no equal”. Indeed, the 
Hewlett-Packard calculators were a great advance over competing models that were unable 
to handle algebraic notation, leaving users with no other choice but to write intermediate 
results on paper. 


Over time, developers of high-quality calculators have adapted to the standard algebraic 
notation rather than forcing its users to learn a new notation. However, those users who have 
made the effort to learn RPN tend to be fanatic proponents, and to this day, some Hewlett- 
Packard calculator models still support it. 


ee eae 
ete 


BOY ee 


Both the HashSet and the TreeSet classes implement the Set interface. Thus, if you 
need a set of objects, you have a choice. 


The TreeSet class uses a 
form of balanced binary © 
tree that guarantees that 
adding and removing an 

element takes O(log(n)) 

time. | 


To use a tree set, the 
elements must be 
comparable. | 


If you have a good hash function for your objects, then hashing 1s 
usually faster than tree-based algorithms. But the balanced trees used 
in the TreeSet class can guarantee reasonable performance, whereas 
the HashSet is entirely at the mercy of the hash function. 

If you don’t want to define a hash function, then a tree set is an 
attractive option. Tree sets have another advantage: The iterators visit 
elements in sorted order rather than the completely random order 
given by the hash codes. 

To use a TreeSet, your objects must belong to a class that imple- 
ments the Comparable interface or you must supply a Comparator 
object. That is the same requirement that you saw in Section 14.8 for 
using the sort and binarySearch methods in the standard library. 


To use a TreeMap, the same requirement holds for the keys. There 1s no require- 
ment for the values. 

For example, the String class implements the Comparable interface. The compareTo 
method compares strings in dictionary order. Thus, you can form tree sets of 
strings, and use strings as keys for tree maps. 
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If the class of the tree set elements doesn’t implement the Comparable interface, or 
the sort order of the compareTo method isn’t the one you want, then you can define 
your own comparison by supplying a Comparator object to the TreeSet or TreeMap 
constructor. For example, 


Comparator comp = new CoinComparator() ; 
Set Ss = new TreeSet(comp) ; 


As described in Advanced Topic 14.5, a Comparator object compares two elements 
and returns a negative integer if the first is less than the second, zero if they are 
identical, and a positive value otherwise. The example program at the end of this 
section constructs a TreeSet of Coin objects, using the coin comparator of Advanced 
Topic 14.5. 


ch16/treeset/TreeSetTester.java 


import java.util.Comparator; 
import java.util.Set; 
import java.util.TreeSet; 


A program to a test a tree set with a comparator for coins. 


public class TreeSetTester 


1 
2 
3 
4 
a ee 
6 
Z 
8 
9 


{ 
10 public static void main(String[] args) 
11 { 
12 Coin coinl = new Coin(0.25, “quarter"); 
13 Coin coin2 = new Coin(0.25, "quarter"); 


14 Coin coin3 = new Coin(0.01, "penny"); 

15 Coin coin4 = new Coin(0.05, "nickel"); 

16 

17 class CoinComparator implements Comparator<Coin> 

18 { 

19 public int compare(Coin first, Coin second) 

20 f 

21 if (first.getValue() < second.getValue()) return -1: 
ce if (first.getValue() == second.getValue()) return 0; 
23 return 1; 

24 } 

25 ; 

26 

27 Comparator<Coin> comp = new CoinComparator(); 

28 Set<Coin> coins = new TreeSet<Coin>(comp) ; 

29 coins.add(coinl); 

30 coins.add(coin2); 

Cail coins.add(coin3); 

32 coins.add(coin4); 

33 
34 for (Coin c : coins) 

35 System.out.print(c.getValue() +" "); 

36 System.out.printInC"Expected: 0.01 0.05 0.25"): 

37 ; 
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Output 


G.0t 0.050225 
Expected: 0.01 0.05 0.25 


SELF CHECK 


13. When would you choose a tree set over a hash set? 


14. Suppose we define a coin comparator whose compare method always returns 0. 
Would the TreeSet function correctly? 


How To 16.1 


Choosing a Container 


Suppose you need to store objects in a container. You have now seen a number of different data 
structures. This How To reviews how to pick an appropriate container for your application. 


Step 1 Determine how you access the elements. 
You store elements in a container so that you can later retrieve them. How do you want to 
access individual elements? You have several choices. 


° It doesn’t matter. Elements are always accessed “in bulk”, by visiting all elements and 
doing something with them. 


e Access by key. Elements are accessed by a special key. Example: Retrieve a bank account 
by the account number. 


e Access by integer index. Elements have a position that is naturally an integer or a pair of 
integers. Example: A piece on a chess board is accessed by a row and column index. 


If you need keyed access, use a map. If you need access by integer index, use an array list or 
array. For an index pair, use a two-dimensional array. 

Step 2 Determine whether element order matters. 

When you retrieve elements from a container, do you care about the order in which they are 
retrieved? You have several choices. 

e It doesn’t matter. As long as you get to visit all elements, you don’t care in which order. 

¢ Elements must be sorted. 

e Elements must be in the same order in which they were inserted. 

To keep elements sorted, use a TreeSet. To keep elements in the order in which you inserted 
them, use a LinkedList, ArrayList, or array. 


Step 3. Determine which operations must be fast. 


You have several choices. 
e It doesn’t matter. You collect so few elements that you aren’t concerned about speed. 
e Adding and removing elements must be fast. 


e Finding elements must be fast. 
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Linked lists allow you to add and remove elements efficiently, provided you are already near 
the location of the change. Changing either end of the linked list is always fast. 

If you need to find an element quickly, use a set. 

At this point, you should have narrowed down your selection to a particular container. If 
you answered “It doesn’t matter” for each of the choices, then just use an ArrayList. It’s a 
simple container that you already know well. 


Step 4 For sets and maps, choose between hash tables and trees. 


If you decided that you need a set or map, you need to pick a particular implementation, 
either a hash table or a tree. 

If your elements (or keys, in case of a map) are strings, use a hash table. It’s more efficient. 

If your elements or keys belong to a type that someone else defined, check whether the 
class implements its own hashCode and equals methods. The inherited hashCode method of 
the Object class takes only the object’s memory address into account, not its contents. If 
there is no satisfactory hashCode method, then you must use a tree. 

If your elements or keys belong to your own class, you usually want to use hashing. 
Define a hashCode and compatible equals method. 


Step 5 If you use a tree, decide whether to supply a comparator. 


Look at the class of the elements or keys that the tree manages. Does that class implement 
the Comparable interface? If so, is the sort order given by the compareTo method the one you 
want? If yes, then you don’t need to do anything further. If no, then you must define a class 
that implements the Comparator interface and define the compare method. Supply an object of 
the comparator class to the TreeSet or TreeMap constructor. 


RANDOM FACT 16.2 


Software Piracy 


As you read this, you have written a few computer programs, and you have experienced 
firsthand how much effort it takes to write even the humblest of programs. Writing a real 
software product, such as a financial application or a computer game, takes a lot of time and 
money. Few people, and fewer companies, are going to spend that kind of time and money if 
they don’t have a reasonable chance to make more money from their effort. (Actually, some 
companies give away their software in the hope that users will upgrade to more elaborate 
paid versions. Other companies give away the software that enables users to read and use 
files but sell the software needed to create those files. Finally, there are individuals who 
donate their time, out of enthusiasm, and produce programs that you can copy freely.) 
When selling software, a company must rely on the honesty of its customers. It is an easy 
matter for an unscrupulous person to make copies of computer programs without paying for 
them. In most countries that is illegal. Most governments provide legal protection, such as 
copyright laws and patents, to encourage the development of new products. Countries that 
tolerate widespread piracy have found that they have an ample cheap supply of foreign soft- 
ware, but no local manufacturers willing to design good software for their own citizens, such 
as word processors in the local script or financial programs adapted to the local tax laws. 
When a mass market for software first appeared, vendors were enraged by the money 
they lost through piracy. They tried to fight back by various schemes to ensure that only the 
legitimate owner could use the software. Some manufacturers used key disks: disks with spe- 
cial patterns of holes burned in by a laser, which couldn’t be copied. Others used dongles: 


: When removing an element 
from a priority queue, the — 


_ priority is retrieved. 
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devices that are attached to a printer port. Legitimate users hated these measures. They paid 
for the software, but they had to suffer through the inconvenience of inserting a key disk 
every time they started the software or having multiple dongles stick out from their com- 
puter. In the United States, market pressures forced most vendors to give up on these copy 
protection schemes, but they are still commonplace in other parts of the world. 

Because it is so easy and inexpensive to pirate software, and the chance of being found out 
is minimal, you have to make a moral choice for yourself. If a package that you would really 
like to have is too expensive for your budget, do you steal it, or do you stay honest and get 
by with a more affordable product? 

Of course, piracy is not limited to software. The same issues arise for other digital prod- 
ucts as well. You may have had the opportunity to obtain copies of songs or movies without 
payment. Or you may have been frustrated by a copy protection device on your music 
player that made it difficult for you to listen to songs that you paid for. Admittedly, it can be 
difficult to have a lot of sympathy for a musical ensemble whose publisher charges a lot of 
money for what seems to have been very little effort on their part, at least when compared to 
the effort that goes into designing and implementing a software package. Nevertheless, it 
seems only fair that artists and authors receive some compensation for their efforts. How to 
pay artists, authors, and programmers fairly, without burdening honest customers, is an 
unsolved problem at the time of this writing, and many computer scientists are engaged in 
research in this area. 


In Section 15.4, you encountered two common abstract data types: stacks and 
queues. Another important abstract data type, the priority queue, collects elements, 
each of which has a priority. A typical example of a priority queue is a collection of 
work requests, some of which may be more urgent than others. 

Unlike a regular queue, the priority queue does not maintain a first- 
in, first-out discipline. Instead, elements are retrieved according to 
their priority. In other words, new items can be inserted in any order. 
But whenever an item is removed, that item has highest priority. 
Ace It is customary to give low values to high priorities, with priority 
1 denoting the highest priority. The priority queue extracts the minimum element 
from the queue. 

For example, consider this sample code: 


element with the highest — 


PriorityQueue<WorkOrder> q = new PriorityQueue<WorkOrder> ; 
q.add(new WorkOrder(3, "Shampoo Ccarpets')); 

q.add(new WorkOrder(1, "Fix overflowing sink")); 

q.add(new WorkOrder(2, "Order cleaning supplies”)); 


When calling q.removeQ) for the first time, the work order with priority 1 1s 
removed. The next call to q.remove() removes the work order whose priority 1s 
highest among those remaining in the queue—in our example, the work order with 
priority 2. 

The standard Java library supplies a PriorityQueue class that is ready for you to 
use. Later in this chapter, you will learn how to supply your own implementation. 
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Keep in mind that the priority queue is an abstract data type. You do not know 
how a priority queue organizes its elements. There are several concrete data struc- 
tures that can be used to implement priority queues. 

Of course, one implementation comes to mind immediately. Just store the ele- 
ments in a linked list, adding new elements to the head of the list. The remove 
method then traverses the linked list and removes the element with the highest pri- 
ority. In this implementation, adding elements is quick, but removing them is slow. 

Another implementation strategy is to keep the elements in sorted order, for 
example in a binary search tree. Then it is an easy matter to locate and remove the 
largest element. However, another data structure, called a heap, is even more suit- 
able for implementing priority queues. 
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Reto Te anaimocee A heap (or, for greater clarity, min-heap) is a binary tree with two 
complete tree in which the special properties. 

values of all nodes are at 
most as large as those of 
their descendants. | 


1. A heap is almost complete: all nodes are filled in, except the last 
level may have some nodes missing toward the right (see 


Figure 16). 


2. The tree fulfills the heap property: all nodes store values that are 
at most as large as the values stored in their descendants (see 
Figure 17). 


It is easy to see that the heap property ensures that the smallest element is stored in 
the root. 


All nodes filled in 


Some nodes missing toward the right 


Figure 16 An Almost Complete Tree 
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Figure 17 
A Heap 


A heap is superficially similar to a binary search tree, but there are two important 
differences. 


1. The shape of a heap is very regular. Binary search trees can have arbitrary 
shapes. 

2. Ina heap, the left and right subtrees both store elements that are larger than 
the root element. In contrast, in a binary search tree, smaller elements are 
stored in the left subtree and larger elements are stored in the right subtree. 


Suppose we have a heap and want to insert a new element. Afterwards, the heap 
property should again be fulfilled. The following algorithm carries out the insertion 
(see Figure 18). 


1. First, add a vacant slot to the end of the tree. 


4) Add vacant slot at end 
Insert 


> = 


Figure 18 Inserting an Element into a Heap 
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@ Demote parents 


Insert — 


Figure 18 (continued) Inserting an Element into a Heap 
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2. Next, demote the parent of the empty slot if it is larger than the element to be 
inserted. That is, move the parent value into the vacant slot, and move the 
vacant slot up. Repeat this demotion as long as the parent of the vacant slot is 
larger than the element to be inserted. (See Figure 18 continued.) 


3. At this point, either the vacant slot is at the root, or the parent of the vacant 
slot is smaller than the element to be inserted. Insert the element into the 
vacant slot. 


We will not consider an algorithm for removing an arbitrary node from a heap. The 
only node that we will remove is the root node, which contains the minimum of all 
of the values in the heap. Figure 19 shows the algorithm in action. 


1. Extract the root node value. 


@ Remove the minimum element from the root 


20 


(2) Move the last element into the root 


Figure 19 Removing the Minimum Value from a Heap 
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oS 


ae a 


& Fix the heap 


| ve. 


Figure 19 (continued) Removing the Minimum Value from a Heap 


2. Move the value of the last node of the heap into the root node, and remove the 
last node. Now the heap property may be violated for the root node, because 
one or both of its children may be smaller. 


3. Promote the smaller child of the root node. (See Figure 19 continued.) Now 
the root node again fulfills the heap property. Repeat this process with the 
demoted child. That is, promote the smaller of its children. Continue until the 
demoted child has no smaller children. The heap property is now fulfilled 
again. This process is called “fixing the heap”. 


Inserting and removing heap elements is very efficient. The reason lies in the bal- 
anced shape of a heap. The insertion and removal operations visit at most / nodes, 
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where h is the height of the tree. A heap of height / contains at least 2-1 elements, 


but less than 2” elements. In other words, if 7 is the number of elements, then 
Piene 2h 
or 
h-1<log,(n)<h 


This argument shows that the insertion and removal operations in a 
heap with n elements take O(log(z)) steps. 

Contrast this finding with the situation of binary search trees. When 
a binary search tree is unbalanced, it can degenerate into a linked list, so 
that in the worst case insertion and removal are O(7) operations. 


Inserting or removing a 
heapelementisan 
— O(log(n)) operation. 


The regular layout ofa Heaps have another major advantage. Because of the regular lay- 
heap makes it possible to — gut of the heap nodes, it is easy to store the node values in an array. 
‘storeheapnodes  ==———‘First store the first layer, then the second, and so on (see Figure 20). 
: eric lently Ula aitay "For convenience, we leave the 0 element of the array empty. Then the 


child nodes of the node with index 7 have index 2-zand2-1+1,and 

the parent node of the node with index i has index i/2. For example, as you can see 
in Figure 20, the children of node 4 are nodes 8 and 9, and the parent is node 2. 

Storing the heap values in an array may not be intuitive, but it is very efficient. 

There is no need to allocate individual nodes or to store the links to the child nodes. 

Instead, child and parent positions can be determined by very simple computations. 


Layer 3 


Layer 4 


Layer 1 Layer 2 Layer 3 Layer 4 
a —, fn 


20 75 43.84 90 57 71 93 91 96 
[0] [1] [2] (3] [4] [£5] [6] [7] [8] [9] [10] 


Figure 20 Storing a Heap in an Array 
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The program at the end of this section contains an implementation of a heap. For 
greater clarity, the computation of the parent and child index positions is carried 
out in methods getParentIndex, getLeftChildIndex, and getRightChi I dIndex. 
For greater efficiency, the method calls could be avoided by using expressions 
index / 2,2 * index, and 2 * index + 1 directly. 

In this section, we have organized our heaps such that the smallest element is 
stored in the root. It is also possible to store the largest element in the root, simply 
by reversing all comparisons in the heap-building algorithm. If there is a possibility 
of misunderstanding, it is best to refer to the data structures as min-heap or max- 
heap. 

The test program demonstrates how to use a min-heap as a priority queue. 


ch16/pqueue/MinHeap.java 


1 import java.util.*; 
2 
3 = 
Zh This class implements a heap. 
2 */ 
6 public class MinHeap 
7 f 
8 ba 
9 Constructs an empty heap. 
10 * / 
11 public MinHeap() 
12 { 
13 elements = new ArrayList<Comparable>(): 
14 elements.add(nul1l); 
15 } 
16 
17 weak 
18 Adds a new element to this heap. 
19 @param newElement the element to add 
20 * 
21 public void add(Comparable newElement) 
22 { 
23 // Add anew leaf 
24 elements.add(null); 
25 int index = elements.sizeQ - 1; 
26 
27 // Demote parents that are larger than the new element 
28 while (index > 1 
29 && getParent (index) .compareTo(newElement) > 9) 
30 { 
31 elements.set(index, getParent(index)): 
32 index = getParentIndex(index) ; 
33 } 
34 
35 // Store the new element in the vacant slot 
36 elements.set(index, newElement); 
37 } 
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Gets the minimum element stored in this heap. 


@return the minimum element 


ve / 
public Comparable peek() 


{ 
} 


return elements.get(1); 


Removes the minimum element from this heap. 


@return the minimum element 


public Comparable remove() 


{ 


} 


slo ta 
wos 


Comparable minimum = elements.get(1); 


// Remove last element 
int lastIndex = elements.sizeQ - 1; 
Comparable last = elements.remove(lastIndex) ; 


if ClastIndex > 1) 
1 


elements.set(l, last); 
fixHeapQ ; 
} 


return minimum; 


Turns the tree back into a heap, provided only the root 
node violates the heap condition. 


private void fixHeap() 


{ 


Comparable root = elements.get(!); 


int lastIndex = elements.sizeQ) - 1; 
// Promote children of removed root while they are larger than last 


int index = 1; 

boolean more = true; 

while (more) 

{ 
int childIndex = getLeftChi ldIndex(index) ; 
if (childIndex <= lastIndex) 


// Get smaller child 


// Get left child first 
Comparable child = getLeftChi ldCindex) ; 
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92 // Use right child instead if it is smaller 
93 if CgetRightChildIndex(index) <= lastIndex 
94 && getRightChi ldCindex).compareTo(child) < 0) 
95 { 
96 childIndex = getRightChi 1dIndex (index) ; 
97 child = getRightChild(Cindex); 
98 t 
99 

100 // Check if larger child is smaller than root 

101 if C(child.compareTo(root) < 0) 

102 { 

103 // Promote child 

104 elements.set(index, child); 

105 index = childIndex: 

106 } 

107 else 

108 { 

109 // root is smaller than both children 

110 more = false; 

111 } 

112 } 

113 else 

114 if 

115 // No children 

116 more = false; 

117 } 

118 } 

119 

120 // Store root element in vacant slot 

121 elements.set(index, root): 

122 } 

123 

124 [= 

125 Returns the number of elements in this heap. 

126 ay 

ie? public int size() 

128 { 

129 return elements.sizeQ) - 1: 

130 

131 

132 poe 

133 Returns the index of the left child. 

134 @param index the index of a node in this heap 

TY @return the index of the left child of the given node 

6 =) 

137 private static int getLeftChildIndex(int index) 

138 { 

139 return 2 * index; 

140 

141 

142 [ee 

143 Returns the index of the right child. 

144 @param index the index of a node in this heap 

145 @return the index of the right child of the given node 


14600 */ 
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147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
Ls 
174 
175 
176 
Ai? 
178 
LW ge 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 } 
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private static int getRightChildIndexCint index) 
{ 
return 2 * index + 1; 


} 


Returns the index of the parent. 
@param index the index of a node in this heap 
@return the index of the parent of the given node 


* / 
private static int getParentIndexCint index) 
{ 
return index / 2; 
} 


Returns the value of the left child. 
@param index the index of a node in this heap 
@return the value of the left child of the given node 


* 7 
private Comparable getLeftChild(int index) 
{ 
return elements.get(2 * index); 
} 


Returns the value of the right child. 
@param index the index of a node in this heap 
@return the value of the right child of the given node 


* / 
private Comparable getRightChild(int index) 
{ 
return elements.get(2 * index + 1); 
} 


Returns the value of the parent. 
@param index the index of a node in this heap 
@return the value of the parent of the given node 
 ] 
private Comparable getParent(int index) 
{ 
return elements.get(index / 2); 


} 


private ArrayList<Comparable> elements; 


ch16/pqueue/HeapDemo.java 


ale ole 
awa 


Z This program demonstrates the use of a heap as a priority queue. 


3 * / 


4 public class HeapDemo 
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public static void main(String[] args) 

{ 
MinHeap q = new MinHeap(); 
q.add(new WorkOrder(3, "Shampoo carpets")); 
q.add(new WorkOrder(7, "Empty trash")); 
q.addCnew WorkOrder(8, "Water plants")); 
q.addCnew WorkOrder(10, "Remove pencil sharpener shavings")); 
q.add(new WorkOrder(6, “Replace light bulb")); 
q.addCnew WorkOrder(1, "Fix broken sink")); 
q.addCnew WorkOrder(9, "Clean coffee maker")); 
q.add(new WorkOrder(2, "Order cleaning supplies")); 
while (q.sizeQ) > 0) 

System.out.printIn(q. remove()); 
} 


ch16/pqueue/WorkOrder.java 


{ 


This class encapsulates a work order with a priority. 


public class WorkOrder implements Comparable 


ale ole 
aioe 


Constructs a work order with a given priority and description. 


@param aPriority the priority of this work order 


@param aDescription the description of this work order 


ale 
aw 


public WorkOrderCint aPriority, String aDescription) 


{ 
priority = aPriority; 
description = aDescription; 


} 


public String toString(Q 
{ 


} 


return "priority=" + priority + 


public int compareTo(Object otherObject) 

{ 
WorkOrder other = (WorkOrder) otherObject; 
if (priority < other.priority) return -1; 
if (priority > other.priority) return 1; 
return 0; 


} 


private int priority; 
private String description; 


, description=" 


+ description; 


The heapsort algorithm is 
based on inserting elements 
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Output 


priority=1, description=Fix broken sink 

priority=2, description=Order cleaning supplies 
priority=3, description=Shampoo carpets 

priority=6, description=Replace light bulb 

priority=/7, description=Empty trash 

priority=8, description=Water plants 

priority=9, description=Clean coffee maker 

priority=10, description=Remove pencil sharpener shavings 


SELF CHECK 


15. The software that controls the events in a user interface keeps the events in a 
data structure. Whenever an event such as a mouse move or repaint request 
occurs, the event is added. Events are retrieved according to their importance. 
What abstract data type is appropriate for this application? 


16. Could we store a binary search tree in an array so that we can quickly locate the 
children by looking at array locations 2 * index and 2 * index + 1? 
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Heaps are not only useful for implementing priority queues, they 
also give rise to an efficient sorting algorithm, heapsort. In its sim- 


into aheap and removing __ Plest form, the algorithm works as follows. First insert all elements 
them in sorted order. to be sorted into the heap, then keep extracting the minimum. 


This algorithm is an O(n log(z)) algorithm: each insertion and 
removal is O(log()), and these steps are repeated times, once for 


Heapsort is an O(n log(n)) each element in the sequence that is to be sorted. 


algorithm. | 


The algorithm can be made a bit more efficient. Rather than 

inserting the elements one at a time, we will start with a sequence of 

values in an array. Of course, that array does not represent a heap. We will use the 

procedure of “fixing the heap” that you encountered in the preceding section as 

part of the element removal algorithm. “Fixing the heap” operates on a binary tree 

whose child trees are heaps but whose root value may not be smaller than the 

descendants. The procedure turns the tree into a heap, by repeatedly promoting the 
smallest child value, moving the root value to its proper location. 

Of course, we cannot simply apply this procedure to the initial sequence of 
unsorted values—the child trees of the root are not likely to be heaps. But we can 
first fix small subtrees into heaps, then fix larger trees. Because trees of size 1 are 
automatically heaps, we can begin the fixing procedure with the subtrees whose 
roots are located in the next-to-lowest level of the tree. 

The sorting algorithm uses a generalized fixHeap method that fixes a subtree with 
a given root index: 


void fixHeapCint rootIndex, int lastIndex) 
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Call fixHeap 
on these nodes 


Call fixHeap 
on these nodes 


SS. . © 22. Gal xtesp: 


| =soomtheroot 


Figure 21 Turning a Tree into a Heap 
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Here, lastIndex is the index of the last node in the full tree. The fixHeap method 
needs to be invoked on all subtrees whose roots are in the next-to-last level. Then 
the subtrees whose roots are in the next level above are fixed, and so on. Finally, the 
fixup is applied to the root node, and the tree is turned into a heap (see Figure 21). 

That repetition can be programmed easily. Start with the /ast node on the next- 
to-lowest level and work toward the left. Then go to the next higher level. The node 
index values then simply run backwards from the index of the last node to the index 
of the root. 


int n = a.length - 1; 
for Cint 1 = (n = 1) / 2: 7 = 0: i-+) 
fixHeap(i, n); 


Note that the loop ends with index 0. When working with a given array, we don’t 
have the luxury of skipping the 0 entry. We consider the 0 entry the root and adjust 
the formulas for computing the child and parent index values. 

After the array has been turned into a heap, we repeatedly remove the root ele- 
ment. Recall from the preceding section that removing the root element is achieved 
by placing the last element of the tree in the root and calling the fixHeap method. 

Rather than moving the root element into a separate array, we will swap the root 
element with the last element of the tree and then reduce the tree length. Thus, the 
removed root ends up in the last position of the array, which is no longer needed by 
the heap. In this way, we can use the same array both to hold the heap (which gets 
shorter with each step) and the sorted sequence (which gets longer with each step). 

There is just a minor inconvenience. When we use a min-heap, the sorted 
sequence is accumulated in reverse order, with the smallest element at the end of the 
array. We could reverse the sequence after sorting is complete. However, it is easier 
to use a max-heap rather than a min-heap in the heapsort algorithm. With this mod- 
ification, the largest value is placed at the end of the array after the first step. After 
the next step, the next-largest value is swapped from the heap root to the second 
position from the end, and so on (see Figure 22). 

The following class implements the heapsort algorithm. 
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ae ~. Already sorted values 


lA 1. - a> 
Root Last element Largest 
of unsorted heap value 


Figure 22 Using Heapsort to Sort an Array 
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ch16/heapsort/HeapSorter.java 


td 
aoa 


This class applies the heapsort algorithm to sort an array. 
public class HeapSorter 


[** 
Constructs a heap sorter that sorts a given array. 
@param anArray an array of integers 


a 

10 public HeapSorter(Cint[] anArray) 
11 af 
12 a = anArray; 
13 } 
14 
15 ies 
+t Sorts the array managed by this heap sorter. 

7 % 
18 public void sort() 
19 { 
20 int n = a.length - 1; 
21 for Cint i = (n - 1) / 2; 1 >= 0; i--) 
22 fixHeap(i, n); 
23 while (n > 0) 
24 { 
25 swap(), n); 
26 nH=3 
27 fixHeap(O, n); 
28 } 
29 } 
30 
31 x 
32 Ensures the heap property for a subtree, provided its 
33 children already fulfil | the heap property. 
34 @param rootIndex the index ae he subtree to be fixed 
35 @param lastIndex the last valid index of the tree that 
36 contains the subtree to be fixed 
37 ny 
38 private void fixHeap(int rootIndex, int lastIndex) 
39 
40 // Remove root 
41 int rootValue = a[rootIndex]; 
42 
43 // Promote children while they are larger than the root 
44 
45 int index = rootiIndex; 
46 boolean more = true; 
47 while (more) 
48 { 
49 int childIndex = getLeftChi1dIndex(Cindex) ; 
50 if CchildIndex <= lastIndex) 
51 - 
52 // Use right child instead if it is larger 


53 int rightChildIndex = getRightChi 1dIndex(index); 


{ 


The Heapsort Algorithm 


if CrightChildIndex <= lastIndex 


&& aLrightChildIndex] > af[childIndex]) 


childIndex = rightChildIndex; 
} 


if Ca[childIndex] > rootValue) 
{ 
// Promote child 


aLindex] = a[childIndex]; 
index = childIndex; 


} 
else 
// Root value is larger than both children 
more = false; 
} 
else 


// No children 
more = false; 
} 
5 


// Store root value in vacant slot 
alindex] = rootValue; 


Swaps two entries of the array. 


@param i the first position to swap 
@param j the second position to swap 


private void swap(int i, int j) 


int temp = ali]; 
ali] = alj]; 
aLj] = temp; 


Returns the index of the left child. 


@param index the index of a node in this heap 
@return the index of the left child of the given node 


private static int getLeftChildIndexCint index) 
{ 


} 


return 2 * jndex + 1; 
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105 Yh 

106 Returns the index of the right child. 

107 @param index the index of a node in this heap 

108 @return the index of the right child of the given node 
109 * / 

110 private static int getRightChildIndex(int index) 
111 { 

112 return 2 * index + 2; 

113 } 

114 

115 private int[] a; 

116 } 

SELF CHECK 

17. Which algorithm requires less storage, heapsort or merge sort? 


18. 


Why are the computations of the left child index and the right child index in the 
HeapSorter different than in MinHeap? 


CHAPTER SUMMARY 


1. 


- PsP 


10. 
11. 


A set is an unordered collection of distinct elements. Elements can be added, 
located, and removed. 


. Sets don’t have duplicates. Adding a duplicate of an element that is already 


present is silently ignored. 
The HashSet and TreeSet classes both implement the Set interface. 
An iterator visits all elements in a set. 


A set iterator does not visit the elements in the order in which you inserted 
them. The set implementation rearranges the elements so that it can locate them 


quickly. 
You cannot add an element to a set at an iterator position. 


A map keeps associations between key and value objects. 


. The HashMap and TreeMap classes both implement the Map interface. 


. To find all keys and values in a map, iterate through the key set and find the 


values that correspond to the keys. 
A hash function computes an integer value from an object. 


A good hash function minimizes collisions —identical hash codes for different 
objects. 
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12. 


13. 


14. 


15. 


16. 


17. 


18. 


19. 


20. 


ya 


22. 
23. 


24. 


25. 


26. 
27. 


28. 


29. 
30. 


31. 


32. 


A hash table can be implemented as an array of buckets—sequences of nodes 
that hold elements with the same hash code. 


If there are no or only a few collisions, then adding, locating, and removing 
hash table elements takes constant or O(1) time. 


The table size should be a prime number, larger than the expected number of 
elements. 


Define hashCode methods for your own classes by combining the hash codes for 
the instance variables. 


Your hashCode method must be compatible with the equals method. 
In a hash map, only the keys are hashed. 
A binary tree consists of nodes, each of which has at most two child nodes. 


All nodes in a binary search tree fulfill the property that the descendants to the 
left have smaller data values than the node data value, and the descendants to 
the right have larger data values. 


When removing a node with only one child from a binary search tree, the child 
replaces the node to be removed. 


When removing a node with two children from a binary search tree, replace it 
with the smallest node of the right subtree. 


If a binary search tree is balanced, then adding an element takes O(log(m)) time. 


Tree traversal schemes include preorder traversal, inorder traversal, and post- 
order traversal. 


Postorder traversal of an expression tree yields the instructions for evaluating 
the expression on a stack-based calculator. 


The TreeSet class uses a form of balanced binary trees that guarantees that add- 
ing and removing an element takes O(log(m)) time. 


To use a tree set, the elements must be comparable. 


When removing an element from a priority queue, the element with the highest 
priority 1s retrieved. 


A heap is an almost complete tree in which the values of all nodes are at most as 
large as those of their descendants. 


Inserting or removing a heap element is an O(log(7)) operation. 


The regular layout of a heap makes it possible to store heap nodes efficiently in 
an array. 


The heapsort algorithm is based on inserting elements into a heap and removing 
them in sorted order. 


Heapsort is an O(n log(n)) algorithm. 
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CLASSES, OBJECTS, AND METHODS 
INTRODUCED IN THIS CHAPTER 


java.uti1.Collection<E> 

contains 

remove 

size 
java.util.HashMap<K, V> 
java.util.HashSet<K, V> 
java.uti].Map<K, V> 

get 

keySet 

put 

remove 
java.util.PriorityQueue<E> 

remove 
java.util1.Set<E> 
java.util.TreeMap<K, V> 
java.util.TreeSet<K, V> 


FURTHER READING 


1. Thomas H. Cormen, Charles E. Leiserson, Ronald L. Rivest, and Clifford Stein, 
Introduction to Algorithms, 2nd edition, MIT Press, 2001. 


REVIEW EXERCISES 


Exercise R16.1. What is the difference between a set and a map? 


Exercise R16.2. What implementations does the Java library provide for the abstract 
set type? 


Exercise R16.3. What are the fundamental operations on the abstract set type? What 
additional methods does the Set interface provide? (Look up the interface in the 
API documentation.) 


Exercise R16.4. The union of two sets A and B is the set of all elements that are con- 
tained in A, B, or both. The intersection is the set of all elements that are contained 
in.A and B. How can you compute the union and intersection of two sets, using the 
four fundamental set operations described on page 701? 


Exercise R16.5. How can you compute the union and intersection of two sets, using 
some of the methods that the java.util.Set interface provides? (Look up the inter- 
face in the API documentation.) 
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Exercise R16.6. Can a map have two keys with the same value? Two values with the 
same key? 


Exercise R16.7, A map can be implemented as a set of (key, value) pairs. Explain. 


Exercise R16.8. When implementing a map as a hash set of (key, value) pairs, how is 
the hash code of a pair computed? 


Exercise R16.9. Verify the hash codes of the strings "Jim" and "Joe" in Table 1. 


Exercise R16.10. From the hash codes in Table 1, show that Figure 6 accurately 
shows the locations of the strings if the hash table size is 101. 


Exercise R16.11. What is the difference between a binary tree and a binary search 
tree? Give examples of each. 


Exercise R16.12. What is the difference between a balanced tree and an unbalanced 
tree? Give examples of each. 


Exercise R16.13. The following elements are inserted into a binary search tree. Make 
a drawing that shows the resulting tree after each insertion. 


Adam 
Eve 
Romeo 
Juliet 
Tom 
Dick 
Harry 


Exercise R16.14. Insert the elements of Exercise R16.13 in opposite order. Then 
determine how the BinarySearchTree.print method prints out both the tree from 
Exercise R16.13 and this tree. Explain how the printouts are related. 


Exercise R16.15. Consider the following tree. In which order are the nodes printed 
by the BinarySearchTree.print method? 


Exercise R16.16. Could a priority queue be implemented efficiently as a binary 
search tree? Give a detailed argument for your answer. 


Exercise R16.17. Will preorder, inorder, or postorder traversal print a heap in sorted 
order? Why or why not? 
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gh-l 


Exercise R16.18. Prove that a heap of height / contains at least elements but less 


than 2” elements. 


Exercise R16.19. Suppose the heap nodes are stored in an array, starting with index 1. 
Prove that the child nodes of the heap node with index z have index 2-zand2-1+ 1, 
and the parent heap node of the node with index z has index i/2. 


Exercise R16.20. Simulate the heapsort algorithm manually to sort the array 
11 27 8 14 45 6 24 81 29 33 
Show all steps. 


Additional review exercises are available in WileyPLUS. 


PROGRAMMING EXERCISES 


Exercise P16.1. Write a program that reads text from System.in and breaks it up into 
individual words. Insert the words into a tree set. At the end of the input file, print 
all words, followed by the size of the resulting set. This program determines how 
many unique words a text file has. 


Exercise P16.2. Insert the 13 standard colors that the Color class predefines (that 1s, 
Color.PINK, Color.GREEN, and so on) into a set. Prompt the user to enter a color by 
specifying red, green, and blue integer values between 0 and 255. Then tell the user 
whether the resulting color is in the set. 


Exercise P16.3. Add a debug method to the HashSet implementation in Section 16.3 
that prints the nonempty buckets of the hash table. Run the test program at the end 
of Section 16.3. Call the debug method after all additions and removals and verity 
that Figure 6 accurately represents the state of the hash table. 


Exercise P16.4. Write a program that keeps a map in which both keys and values are 
strings —the names of students and their course grades. Prompt the user of the pro- 
gram to add or remove students, to modify grades, or to print all grades. The print- 
out should be sorted by name and formatted like this: 


Carl: B+ 
Joe: C 
Sarah: A 


Exercise P16.5. Reimplement Exercise P16.4 so that the keys of the map are objects 
of class Student. A student should have a first name, a last name, and a unique 
integer ID. For grade changes and removals, lookup should be by ID. The printout 
should be sorted by last name. If two students have the same last name, then use the 
first name as tie breaker. If the first names are also identical, then use the integer ID. 
Aint: Use two maps. 
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Exercise P16.6. Supply compatible hashCode and equals methods to the Student class 
described in Exercise P16.5. Test the hash code by adding Student objects to a hash 
set. 


Exercise P16.7. Supply compatible hashCode and equals methods to the BankAccount 
class of Chapter 7. Test the hashCode method by printing out hash codes and by 
adding BankAccount objects to a hash set. 


Exercise P16.8. Design an IntTree class that stores only integers, not objects. Support 
the same methods as the BinarySearchTree class in the book. 


Exercise P16.9. Design a data structure IntSet that can hold a set of integers. Hide 
the private implementation: a binary search tree of Integer objects. Provide the 
following methods: 


e A constructor to make an empty set 
© void add(int x) to add x if it is not present 
@ void remove(int x) to remove x if it is present 
@ void print() to print all elements currently in the set 
® boolean find(int x) to test whether x is present 
Exercise P16.10. Reimplement the set class from Exercise P16.9 by using a 


TreeSet<Integer>. In addition to the methods specified in Exercise P16.9, supply an 
iterator method yielding an object that supports only the hasNext/next methods. 


The next method should return an int, not an object. For that reason, you cannot 
simply return the iterator of the tree set. 


Exercise P16.11. Reimplement the set class from Exercise P16.9 by using a 
TreeSet<Integer>. In addition to the methods specified in Exercise P16.9, supply 
methods 


IntSet unionCIntSet other) 
IntSet intersectionCIntSet other) 


that compute the union and intersection of two sets. 


Exercise P16.12. Implement the szeve of Eratosthenes: a method for computing prime 
numbers, known to the ancient Greeks. Choose an n. This method will compute all 
prime numbers up to 1. First insert all numbers from 2 to 7 into a set. Then erase all 
multiples of 2 (except 2); that is, 4, 6, 8, 10, 12,.... Erase all multiples of 3; that is, 6, 
9-12,.15;3.%%5Go up to Vn. Then print the set. 


Exercise P16.13. Write a method of the BinarySearchTree class 

Comparable smallest() 
that returns the smallest element of a tree. You will also need to add a method to the 
Node class. 


Exercise P16.14. Change the BinarySearchTree.print method to print the tree as a 
tree shape. You can print the tree sideways. Extra credit if you instead display the 
tree with the root node centered on the top. 
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Exercise P16.15. Implement methods that use preorder and postorder traversal to 
print the elements in a binary search tree. 


Exercise P16.16. In the BinarySearchTree class, modify the remove method so that a 
node with two children is replaced by the largest child of the left subtree. 
Exercise P16.17. Suppose an interface Visitor has a single method 
void visit(Object obj) 
Supply methods 


void inOrder(Visitor v) 

void preOrder(Visitor v) 

void postOrder(Visitor v) 
to the BinarySearchTree class. These methods should visit the tree nodes 1n the spec- 
ified traversal order and apply the visit method to the data of the visited node. 


Exercise P16.18. Apply Exercise P16.17 to compute the average value of the elements 
in a binary search tree filled with Integer objects. That is, supply an object of an 
appropriate class that implements the Visitor interface. 


Exercise P16.19. Modify the implementation of the MinHeap class so that the parent 
and child index positions and elements are computed directly, without calling 


helper methods. 


Exercise P16.20. Modify the implementation of the MinHeap class so that the 0 
element of the array is not wasted. 


Exercise P16.21. Time the results of heapsort and merge sort. Which algorithm 
behaves better in practice? 


Additional programming exercises are available in WileyPLUS. 


PROGRAMMING PROJECTS — 


Project 16.1. Implement a BinaryTreeSet class that uses a TreeSet to store its ele- 
ments. You will need to implement an iterator that iterates through the nodes in 
sorted order. This iterator is somewhat complex, because sometimes you need to 
backtrack. You can either add a reference to the parent node in each Node object, or 
have your iterator object store a stack of the visited nodes. 


Project 16.2. Implement an expression evaluator that uses a parser to build an 
expression tree, such as in Section 16.6. (Note that the resulting tree is a binary tree 
but not a binary search tree.) Then use postorder traversal to evaluate the expres- 
sion, using a stack for the intermediate results. 


Project 16.3. Program an animation of the heapsort algorithm, displaying the tree 
graphically and stopping after each call to fixHeap. 
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ANSWERS TO SELF-CHECK QUESTIONS 


1. Efficient set implementations can quickly test whether a given element is a 
member of the set. 


2. Sets do not have an ordering, so it doesn’t make sense to add an element at a 
particular iterator position, or to traverse a set backwards. 


3. A set stores elements. A map stores associations between keys and values. 
4. The ordering does not matter, and you cannot have duplicates. 


5. Yes, the hash set will work correctly. All elements will be inserted into a single 


bucket. 

It locates the next bucket in the bucket array and points to its first element. 
31 x 1164+ 111 =3707. 

i 


In a tree, each node can have any number of children. In a binary tree, a node 
has at most two children. In a balanced binary tree, all nodes have approxi- 
mately as many descendants to the left as to the right. 


6 On 


10. For example, Sarah. Any string between Romeo and Tom will do. 
11. For both trees, the inorder traversal is 3 + 4 * 5. 


12. No—for example, consider the children of +. Even without looking up the Uni- 
code codes for 3, 4, and +, it is obvious that + isn’t between 3 and 4. 


13. When it is desirable to visit the set elements in sorted order. 


14. No—it would never be able to tell two coins apart. Thus, it would think that all 
coins are duplicates of the first. 


15. A priority queue is appropriate because we want to get the important events 
first, even if they have been inserted later. 


16. Yes, but a binary search tree isn’t almost filled, so there may be holes in the 
array. We could indicate the missing nodes with nu11 elements. 


17. Heapsort requires less storage because it doesn’t need an auxiliary array. 


18. The MinHeap wastes the 0 entry to make the formulas more intuitive. When sort- 
ing an array, we don’t want to waste the 0 entry, so we adjust the formulas 
instead. 
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Programming 


CHAPTER GOALS 


® To understand the objective of generic programming 


® To be able to implement generic classes and methods 


® To understand the execution of generic methods in the 
virtual machine 


® To know the limitations of generic programming in Java 


® To understand the relationship between generic types 
and inheritance 


® To learn how to constrain type variables 


Generic programming involves the design and implementation of data structures 
and algorithms that work for multiple types. You are already familiar with the 
generic ArrayList class that can be used to produce array lists of arbitrary types. In 


this chapter, you will learn how to implement your own generic classes. 
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17.1 Typ C Varia b x : SI ee ee 


Generic programming is the creation of programming constructs that can be used 
with many different types. For example, the Java library programmers who imple- 
mented the ArrayList class engaged in generic programming. As a result, you can 
form array lists that collect different types, such as ArrayList<String>, Array- 
List<BankAccount>, and so on. 

The LinkedList class that we implemented in Section 15.2 is also an example of 
generic programming—you can store objects of any class inside a LinkedList. How- 

ever, that LinkedList class achieves genericity with a different mechanism. It is a 

single LinkedList class that stores values of type Object. You can, if you like, store a 

String and a BankAccount object into the same LinkedList. 

Our LinkedList class implements genericity by using inheritance. 
save Ce netic It stores objects of any class that inherits from Object. In contrast, 
programming can be h — Me ex ce ees 
achieved with inheritance te ArrayList class uses type variables to achieve genericity—you 
erwin Bibe variables need to specify the type of the objects that you want to store. — 

Note that only our LinkedList class of Chapter 15 uses inheritance. 

The standard Java library has a LinkedList class that uses type variables. In the next 

section, we will add type variables to our LinkedList class as well. 

The ArrayList class is a generic class: it has been declared with a 


A generic class has one or —pyne variable E. The type variable denotes the element type: 
more type variables. 


public class ArrayList<E> 


of 
public ArrayListQ@ { .. . } 
public void add(E element) { .. . } 


: 


Here, E is the name of a type variable, not a Java keyword. You could use another 
name, such as ElementType, instead of E. However, it is customary to use short, 
uppercase names for type parameters. 


Type variables can be 
instantiated with class or 
interface types. face type, for example 


Type variables make 
generic code safer and 
easier to read. 
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In order to use a generic class, you need to instantiate the type vari- 
able, that is, scape an actual type. You can supply any class or inter- 


ArrayList<BankAccount> 
ArrayList<Measurable> 


However, you cannot substitute any of the eight primitive types for a type variable. 
It would be an error to declare an ArrayList<double>. Use the corresponding wrap- 
per class instead, such as ArrayList<Double>. 

The type that you supply replaces the type variable in the interface of the class. 
For example, the add method for ArrayList<BankAccount> has the type variable E 
replaced with the type BankAccount: 


public void add(BankAccount element) 
Contrast that with the add method of our LinkedList class: 
public void add(Object element) 


The ArrayList methods are safer. It is impossible to add a String object into an 
ArrayList<BankAccount>, but you can add a String into a LinkedList that is intended 
to hold bank accounts. 


ArrayList<BankAccount> accountsl = new ArrayList<BankAccount>() ; 
LinkedList accounts2 = new LinkedListQ; // Should hold BankAccount objects 
accountsl.add("my savings"); // Compile-time error 

accounts2.add("my savings"); // Not detected at compile time 


The latter will give you grief when some other part of the code retrieves the string, 
believing it to be a bank account: 


BankAccount account = (BankAccount) accounts2.getFirst(); // Run-time error 


Code that uses the generic ArrayList class is also easier to read. When 
you spot an ArrayList<BankAccount>, you know right away that it 
must contain bank accounts. When you see a LinkedList, you have to 
study the code to find out what it contains. 

In Chapters 15 and 16, we used inheritance to implement generic linked lists, 
hash tables, and binary trees, because you were already familiar with the concept of 
inheritance. Using type variables requires new syntax and additional techniques— 
those are the topic of this chapter. 


SYNTAX 17.1 Instantiating a Generic Class 


GenericClassName<Type,, Typez, . - +> 


Example: 


ArrayList<BankAccount> 
HashMap<String, Integer> 


Purpose: 


To supply specific types for the type variables of a generic class 
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Type variables of a generic 
class follow the class 
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SELF CHECK 


1. The standard library provides a class HashMap<K, V> with key type K and value 
type V. Declare a hash map that maps strings to integers. 


2. The binary search tree class in Chapter 16 is an example of generic program- 
ming because you can use it with any classes that implement the Comparable 
interface. Does it achieve genericity through inheritance or type variables? 


a C| dSSeé 1 Bn ha ak Se Vee ae Se ig a CTS 
ere re ye Be een as Be ee i eee Mkts ite + oe I ee ee deere ter cle ee tiie Aad ge Se ews og hate 
SID oe oS en YA Pope a en ee Tena A See aa ie Oo epee ie ig bee ee 


In this section, you will learn how to implement your own generic classes. We will 
first start out with a very simple generic class that stores pairs of objects. Then we 
will turn the LinkedList class of Chapter 15 into a generic class. 

Our first example for writing a generic class stores pairs of objects, each of which 
can have an arbitrary type. For example, 


Pair<String, BankAccount> result 
= new Pair<String, BankAccount>(C"Harry Hacker", harrysChecking); 


The getFirst and getSecond methods retrieve the first and second values of the pair. 


String name = result.getFirstQ; 
BankAccount account = result.getSecond() ; 


This class can be useful when you implement a method that computes two values at 
the same time. A method cannot simultaneously return a String and a BankAccount, 
but it can return a single object of type Pair<String, BankAccount>. 

The generic Pair class requires two type variables, one for the type of the first 
element and one for the type of the second element. 

We need to give names to the type variables. It is considered good form to give 
short uppercase names for type variables, such as the following: 


Type Variable Name Meaning 
E Element type in a collection 
K Key type in a map 
V Value type in a map 
To General type 
Su Additional general types 


You place the type variables for a generic class after the class name, 
enclosed in angle brackets (< and >): 


- name and are enclosed ins public class Pair<T, S> 
angle brackets. 


Use type variables for the | 
types of generic fields, 
method parameters, and _ 


return values. 
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When you define the fields and methods of the class, use the type variable T for 
the first element type and S for the second element type: 


public class Pair<I, S> 


{ 
public Pair(l firstElement, S secondElement) 


{ 
first = firstElement; 
second = secondElement; 


} 
public T getFirst(Q) { return first; } 
public S getSecond() { return second; } 


private T first; 
private S second; 


} 


This completes the definition of the generic Pair class. It is now 
ready to use whenever you need to form a pair of two objects of arbi- 
trary types. 

As asecond example, let us turn our linked list class into a generic 
class. This class only requires one type variable for the element type, 
which we will call E. 


public class LinkedList<E> 


In the case of the linked list, there is a slight complication. Unlike the Pair class, the 
LinkedList class does not store the elements in its instance fields. Instead, a linked 
list manages a sequence of nodes, and the nodes store the data. Our LinkedList class 
uses an inner class Node for the nodes. The Node class must be modified to express 
the fact that each node stores an element of type E. 


public class LinkedList<E> 


1 
private Node first; 
private class Node 
{ 
public E data; 
public Node next; 
} 
} 


The implementation of some of the methods requires local variables whose type is 
variable, for example: 


public E removeFirstQ 
{ 
if (first == null) 
throw new NoSuchElementException() ; 
E element = first.data; 
first = first.next; 
return element; 
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Overall, the process is straightforward. Use the type E whenever you receive, 
return, or store an element object. Complexities arise only when your data struc- 
ture uses helper classes, such as the nodes and iterators in a linked list. If the helpers 
are inner classes, you need not do anything special. However, helper types that are 
defined outside the generic class need to become generic classes as well. 

Following 1s the complete reimplementation of our LinkedList class, as a generic 
class with a type variable. 


SYNTAX 17.2 Defining a Generic Class 


accessSpecifier Class GenericClassName<TypeVariable,, TypeVariabley, . . .> 
i 

constructors 

methods 

fields 
c 


Example: 

public class Pair<T, S> 
{ 

} 


Purpose: 


To define a generic class with methods and fields that depend on type variables 


ch17/genlist/LinkedList.java 


1 import java.util.NoSuchElementException; 


3 [*% 

4. A linked list is a sequence of nodes with efficient 
5 element insertion and removal. This class 

6 contains a subset of the methods of the standard 
7 java.util.LinkedList class. 

8 


9 public class LinkedList<E> 


10 { 

11 /** 

12 Constructs an empty linked list. 
13 */ 

14 public LinkedList() 

15 { 

16 first = null; 

17 } 


Implementing Generic Classes 


Yi * 
Returns the first element in the linked list. 
@return the first element in the linked list 


public E getFirst() 


{ 
if (first == null) 
throw new NoSuchElementException() ; 
return first.data; 
; 
Removes the first element in the linked list. 
@return the removed element 
* / 
public E removeFirst() 
{ 
if (first == null) 
throw new NoSuchElementException() ; 
E element = first.data; 
first = first.next; 
return element; 
} 
7* * 


Adds an element to the front of the linked list. 
@param element the element to add 


public void addFirst(E element) 


1 
Node newNode = new Node(); 
newNode.data = element; 
newNode.next = first; 
first = newNode; 

} 

{/* * 


Returns an iterator for iterating through this list. 
@return an iterator for iterating through this list 


* / 
public ListIterator<E> listIterator() 


{ 
: 


return new LinkedListiteratorQ(; 


private Node first; 


private class Node 


i 
public E data; 
public Node next; 


} 
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private class LinkedListIterator implements ListIterator<E> 


[** 
Constructs an iterator that points to the front 
of the linked list. 
public LinkedListIterator(Q 
{ 
position = null; 
previous = null; 
} 
[R* 


Moves the iterator past the next element. 
@return the traversed element 


* / 
public E nextQ) 
{ 
if ClhasNextQ) 
throw new NoSuchElementException() ; 
previous = position; // Remember for remove 


if Cposition == null) 
position = first; 

else 
position = position.next; 


return position.data; 


Tests if there is an element after the iterator 
position. 
@return true if there is an element after the iterator 
position 


public boolean hasNext() 


{ 
if Cposition == null) 
return first != null; 
else 
return position.next != null; 
} 
[x 


Adds an element before the iterator position 
and moves the iterator ess the inserted element. 
@param element the element to add 


public void add(E element) 


{ 
if (position == null) 
1 
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addFirst(element) ; 
HOSTtiOn = Tifst? 


} 
else 
{ 
Node newNode = new Node(); 
newNode.data = element; 
newNode.next = position.next; 
position.next = newNode; 
position = newNode; 
5 
previous = position; 
$ 
Vi 4 


Removes the last traversed element. This method may 
only be called after a call to the next method. 


public void remove() 


{ 
if (previous == position) 
throw new IllegalStateException() ; 


If (position == first) 


{ 
removeFirst(); 
} 
else 
{ 
previous.next = position.next; 
} 
position = previous; 
} 
j. ¥ 


Sets the last traversed element to a different 
value. 
@param element the element to set 


public void set(E element) 
{ 
if (position == null) 
throw new NoSuchElementException() ; 
position.data = element; 


5 


private Node position; 
private, Node previous; 
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ch17/genlist/Listlterator.java 


Ll /** 
2 A list iterator allows access to a position in a linked list. 
3 This interface contains a subset of the methods of the 
4, standard java.util.ListIterator interface. The methods for 
5 backward traversal are not included. 
6 * 
7 public interface ListIterator<E> 
8 f{ 
9 Pieris 
10 Moves the iterator past the next element. 
11 @return the traversed element 
12 * / 
13 E next); 
14 
15 ps 
16 Tests if there is an element after the iterator 
17 position. 
18 @return true if there is an element after the iterator 
19 position 
20 7 
21 boolean hasNext(); 
22 
23 ses 
24 Adds an element before the iterator position 
25 and moves the iterator past the inserted element. 
26 @param element the ee to add 
27 * / 
28 void add(E element); 
29 
30 as 
31 Removes the last traversed element. This method may 
32 only be called after a call to the next method. 
33 * 
34 void remove(); 
35 
36 wk 
a7 Sets the last traversed element to a different 
38 value. 
39 @param element the element to set 
40 * / 
41 void set(E element); 
42 } 


ch17/genlist/ListTester.java 


l [** 
2 A program that tests the LinkedList class. 


4 public class ListTester 
> { 
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41 
42 } 


Output 
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public static void main(String[] args) 


{ 


} 


LinkedList<String> staff = new LinkedList<String>() ; 
staff.addFirstC"Tom"); 

staff.addFirstC'Romeo"); 

staff.addFirstC"Harry"); 

staff.addFirstC"Dick"); 


// \ inthe comments indicates the iterator position 


ListIterator<String> iterator = staff.listIterator(); // |DHRT 


jterator.nextQ); // D|HRT 
jterator.nextQ); // DH|RT 


// Add more elements after second element 


iterator.addC"Juliet"); // DHI|RT 
iterator.add("Nina"); // DHIN|RT 


iterator.nextQ); // DHINR|T 
// Remove last traversed element 
iterator.remove(); // DHIN|T 
// Print all elements 


jterator = staff.listiteratorQ; 
while Citerator.hasNext()) 
< 
String element = iterator.nextQ; 
System.out.printCelement + " "); 
} 
System.out.printinQ; 


System.out.printIn("Expected: Dick Harry Juliet Nina Tom"); 


Dick Harry Juliet Nina Tom 
Expected: Dick Harry Juliet Nina Tom 


SELF CHECK 
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3. How would you use the generic Pair class to construct a pair of strings "He110" 
and "World"? 


4, What change was made to the ListIterator interface, and why was that change 
necessary? 


776 CHAPTER 17 #8 Generic Programming 


17.3. Generic Methods 


Perron eet Ree or A generic method is a method with a type variable. You can think of 

deanedane de ordinan’ it as a template for a set of methods that differ only by one or more 

and generic classes. types. One way of defining a generic method is by starting with a 
method that operates on a specific type. As an example, consider the 
following print method: 


public class ArrayUti l 


{ 
Prints all elements in an array of strings. 
@param a the array to print 
* / 
public static void print(String[] a) 
{ 
for (String e : a) 
System.out.print(e +" "); 
System.out.printInd; 
i; 
} 


This method prints the elements in an array of strings. However, we may want to 
print an array of Rectangle objects instead. Of course, the same algorithm works for 
an array of any type. 

In order to make the method into a generic method, replace String 
with a type variable, say E, to denote the element type of the array. 
Add a type variable list, enclosed in angle brackets, between the 
modifiers (public static) and the return type (void): 


Supply the type variables 
of a generic method 
between the modifiers and 
the method return type. 
public static <E> void print(E[] a) 


for (Ee: a) 
System.out.print(e +" "); 
System.out.printInQ; 

; 
Wheriealince congue When you call the generic method, you need not specify which type 
method scan need aot to use for the type variable. (In this regard, generic methods differ 
emniene pe from generic classes.) Simply call the method with appropriate 
waiaaisices parameters, and the compiler will match up the type variables with 


the parameter types. For example, consider this method call: 


Rectangle[] rectangles =... .; 
ArrayUtil.printCrectangles) ; 


The type of the rectangles parameter is Rectangle[], and the type of the parameter 
variable is E[]. The compiler deduces that E is Rectangle. 

This particular generic method is a static method in an ordinary class. You can 
also define generic methods that are not static. You can even have generic methods 
in generic classes. 


17.4 « Constraining Type Variables aa 


SYNTAX 17.3 Defining a Generic Method 


modifiers <TypeVariable,, TypeVariabley, . . .> returnType methodName (parameters) 


{ 
body 


} 


Example: 


public static <E> void printCEll a) 
{ 


} 


Purpose: 


To define a generic method that depends on type variables 


As with generic classes, you cannot replace type variables with primitive types. 
The generic print method can print arrays of any type except the eight primitive 
types. For example, you cannot use the generic print method to print an array of 
type int[]. That is not a major problem. Simply implement a printCint[] a) 
method in addition to the generic print method. 


SELF CHECK 


5. Exactly what does the generic print method print when you pass an array of 
BankAccount objects containing two bank accounts with zero balances? 


6. Is the getFirst method of the Pair class a generic method? 


17.4 Constraining T 


It is often necessary to specify what types can be used in a generic 
class or method. Consider a generic min method that finds the small- 
est element in an array list of objects. How can you find the smallest 
slenieut when you know nothing about the element type? You need to have a 
mechanism for comparing array elements. One solution is to require that the ele- 
ments belong to a type that implements the Comparable interface. In this situation, 
we need to constrain the type variable. 


Type variables can be | 
constrained ed bounds. 


public static <E extends Comparable> E min(E[] a) 


{ 
E smallest = a[0]; 
for (int i = 1; i < a.length; i++) 
if Cali].compareTo(smallest) < 0) smallest = a[1i]J; 
return smallest 
I 
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You can call min with a String[] array but not with a Rectangle[] array—the String 
class implements Comparable, but Rectangle does not. 

The Comparable bound is necessary for calling the compareTo method. Had it been 
omitted, then the min method would not have compiled. It would have been illegal 
to call compareTo on a[i] if nothing is known about its type. (Actually, the Compara- 
ble interface is itself a generic type, but for simplicity we do not supply a type 
parameter. See Advanced Topic 17.1 for more information.) 

Very occasionally, you need to supply two or more type bounds. Then you sepa- 
rate them with the & character, for example 


<E extends Comparable & Cloneable> 


The extends keyword, when applied to type variables, actually means “extends or 
implements”. The bounds can be either classes or interfaces, and the type variable 
can be replaced with a class or interface type. 


SELF CHECK 


7. How would you constrain the type variable for a generic BinarySearchTree 
class? 


8. Modity the min method to compute the minimum of an array of elements that 
implements the Measurable interface of Chapter 9. 


COMMON ERROR 17.1 
Genericity and Inheritance 


If SavingsAccount is a subclass of BankAccount, is ArrayList<SavingsAccount> a subclass of 
ArrayList<BankAccount>? Perhaps surprisingly, it is not. Inheritance of type parameters does 
not lead to inheritance of generic classes. There is no relationship between Array- 
List<SavingsAccount> and ArrayList<BankAccount>. 

This restriction is necessary for type checking. Suppose it was possible to assign an Array- 
List<SavingsAccount> object to a variable of type ArrayList<BankAccount>: 


ArrayList<SavingsAccount> savingsAccounts 
= new ArrayList<SavingsAccount>(); 
ArrayList<BankAccount> bankAccounts = savingsAccounts; 
// Not legal, but suppose it was 
BankAccount harrysChecking = new CheckingAccount(); 
bankAccounts.add(harrysChecking); // OK—can add BankAccount object 


But bankAccounts and savingsAccounts refer to the same array list! If the assignment was 
legal, we would be able to add a CheckingAccount into an ArrayList<SavingsAccount>. 

In many situations, this limitation can be overcome by using wildcards—see Advanced 
Topic 17.1. 
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ADVANCED Topic 17.1 


Wildcard Types 


It is often necessary to formulate subtle constraints of type variables. Wildcard types were 
invented for this purpose. There are three kinds of wildcard types: 


Name Syntax - Meaning 
Wildcard with lower bound =? extends B Any subtype of B 
Wildcard with upper bound ? super B Any supertype of B 
Unbounded wildcard ? Any type 


A wildcard type is a type that can remain unknown. For example, we can define the follow- 
ing method in the LinkedList<E> class: 


public void addAl1(CLinkedList<? extends E> other) 
{ 


ListIterator<E> iter = other. listIterator(; 
while Citer.hasNext()) add(iter.next()); 


} 


The method adds all elements of other to the end of the linked list. 

The addA11 method doesn’t require a specific type for the element type of other. Instead, 
it allows you to use any type that is a subtype of E. For example, you can use addA11 to add a 
LinkedList<SavingsAccount> to a LinkedList<BankAccount>. 

To see a wildcard with a super bound, have another look at the min method of the preced- 
ing section. Recall that Comparable is a generic interface; the type parameter of the Comparable 
interface specifies the parameter type of the compareTo method. 


public interface Comparable<T> 


{ 


int compareTo(] other) 


} 
Therefore, we might want to specify a type bound: 
public static <E extends Comparable<E>> E min(E[] a) 


However, this bound is too restrictive. Suppose the BankAccount class implements 
Comparable<BankAccount>. Then the subclass SavingsAccount also implements Compara- 
ble<BankAccount> and not Comparable<SavingsAccount>. If you want to use the min method 
with a SavingsAccount array, then the type parameter of the Comparable interface should be 
any supertype of the array element type: 


public static <E extends Comparable<? super E>> E min(E[] a) 

Here is an example of an unbounded wildcard. The Collections class defines a method 
public static void reverse(List<?> list) 

You can think of that declaration as a shorthand for 


public static <T> void reverse(List<T> list) 
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The virtual machine that executes Java programs does not work with 
generic classes or methods. Instead, it uses raw types, in which the 
type variables are replaced with ordinary Java types. Each type vari- 
able is replaced with its bound, or with Object if it is not bounded. 

The compiler erases the type variables when it compiles generic 
classes and methods. For example, the generic class Pair<T, S> turns 
into the following raw class: 


public class Pair 


{ 
public Pair(Object firstElement, Object secondElement) 


{ 


first = firstElement; 
second = secondElement; 


I 
public Object getFirstQ) { return first; } 
public Object getSecond(Q) { return second; } 


private Object first; 
private Object second; 


} 


As you can see, the type variables T and S have been replaced by Object. The result is 
an ordinary class. 

The same process is applied to generic methods. After erasing the type parameter, 
the min method of the preceding section turns into an ordinary method: 


public static Comparable min(Comparable[] a) 


{ 
Comparable smallest = a[0]; 
for Cint i = 1; i < a.length; i++) 
if Cali].compareTo(smallest) < 0) smallest = afi]; 
return smallest; 
} 


Knowing about raw types helps you understand limitations of Java generics. For 
example, you cannot replace type variables with primitive types. Erasure turns type 
variables into the bounds type, such as Object or Comparable. The resulting types 
can never hold values of primitive types. 

PE eee Raw types are necessary when you interface with legacy code that 
was written before generics were added to the Java language. For 
example, if a legacy method has a parameter ArrayList (without a 
type variable), you can pass an ArrayList<String> or Array- 
List<BankAccount>. This is not completely safe—after all, the legacy 
method might insert an object of the wrong type. The compiler will issue a warning, 
but your program will compile and run. 
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SELF CHECK 


9. What is the erasure of the print method in Section 17.3? 
10. What is the raw type of the LinkedList<E> class in Section 17.2? 


COMMON ERROR 17.2 


Writing Code That Does Not Work After Types Are Erased 


Generic classes and methods were added to Java several years after the language became suc- 
cesstul. The language designers decided to use the type erasure mechanism because it makes 
it easy to interface generic code with legacy programs. As a result, you may run into some 
programming restrictions when you write generic code. 

For example, you cannot construct new objects of a generic type. For example, the fol- 
lowing method, which tries to fill an array with copies of default objects, would be wrong: 


public static <E> void fillwithDefaults(CE[] a) 
{ 


for Cint i = 0; 1 < a. length; i++) 
ali] = new EQ); // ERROR 
} 


To see why this is a problem, carry out the type erasure process, as if you were the compiler: 


public static void fillWithDefaults(Object[] a) 


{ 
for Cint i = 0; 1 < a. length; i++) 
ali] = new Object(); // Not useful 
$ 


Of course, if you start out with a Rectangle[] array, you don’t want it to be filled with 
Object instances. But that’s what the code would do after erasing types. 

In situations such as this one, the compiler will report an error. You then need to come up 
with another mechanism for solving your problem. In this particular example, you can sup- 
ply a default object: 


public static <E> void fillWithDefaults(E[] a, E defaultValue) 
{ 


for Cint i = 0; 1 < a. length; i++) 
afi] = defaultValue; 
} 


Similarly, you cannot construct an array of a generic type. Because an array construction 
expression new E[] would be erased to new Object[], the compiler disallows it. 
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COMMON ERROR 17.3 
Using Generic Types in a Static Context 


You cannot use type variables to define static frelds, static methods, or static inner classes. 
For example, the following would be illegal: 


public class LinkedList<E> 


{ 
private static E defaultValue; // ERROR 
public static List<E> replicate(E value, int n) { ...}// ERROR 
private static class Node { public E data; public Node next; } // ERROR 
} 


In the case of static fields, this restriction is very sensible. After the generic types are erased, 
there is only a single field LinkedList.defaultValue, whereas the static field declaration gives 
the false impression that there is a separate field for each LinkedList<E>. 

For static methods and inner classes, there is an easy workaround; simply add a type 
parameter: 


public class LinkedList<E> 


{ 


public static <T> List<T> replicate(T value, int n) {...}// OK 
private static class Node<T> { public T data; public Node<T> next; } // OK 


CHAPTER SUMMARY 

1. In Java, generic programming can be achieved with inheritance or with type vari- 
ables. 

. A generic class has one or more type variables. 

. Type variables can be instantiated with class or interface types. 


. Type variables make generic code safer and easier to read. 


a -&- Ww N 


. Type variables of a generic class follow the class name and are enclosed in angle 
brackets. 


6. Use type variables for the types of generic fields, method parameters, and return 
values. 


7. Generic methods can be defined inside ordinary and generic classes. 


8. Supply the type variables of a generic method between the modifiers and the 
method return type. 


9. When calling a generic method, you need not instantiate the type variables. 
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10. Type variables can be constrained with bounds. 
11. The virtual machine works with raw types, not with generic classes. 
12. The raw type of a generic type is obtained by erasing the type variables. 


13. To interface with legacy code, you can convert between generic and raw types. 


REVIEW EXERCISES 


Exercise R17.1. What is a type variable? 
Exercise R17.2. What is the difference between a generic class and an ordinary class? 
Exercise R17.3. What is the difference between a generic class and a generic method? 


Exercise R17.4. Find an example of a non-static generic method in the standard Java 
library. 


Exercise R17.5. Find four examples of a generic class with two type parameters in the 
standard Java library. 


Exercise R17.6. Find an example of a generic class in the standard library that is not a 
collection class. 


Exercise R17.7. Why is a bound required for the type variable T in the following 
method? 


<T extends Comparable> int binarySearch(T[] a, T key) 


Exercise R17.8. Why is a bound not required for the type variable E in the HashSet<E> 
class? 


Exercise R17.9. What is an ArrayList<Pair<T, T>>? 


Exercise R17.10. Explain the type bounds of the following method of the Collections 
class: 


public static <I extends Comparable<? super T>> void sort(List<T> a) 


Why doesn’t T extends Comparable or T extends Comparable<T> suffice? 


Exercise R17.11. What happens when you pass an ArrayList<String> to a method 
with parameter ArrayList? Try it out and explain. 


Exercise R17.12. What happens when you pass an ArrayList<String> to a method 
with parameter ArrayList, and the method stores an object of type BankAccount into 
the array list? Try it out and explain. 


Exercise R17.13. What is the result of the following test? 


ArrayList<BankAccount> accounts = new ArrayList<BankAccount>Q) ; 
if Caccounts instanceof ArrayList<String>) . 


Try it out and explain. 
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Exercise R17.14. If a class implements the generic Iterable interface, then you can use 
its objects in the “for each” loop—see Advanced Topic 15.1. Describe the needed 
modifications to the LinkedList<E> class of Section 17.2. 


Additional review exercises are available in WileyPLUS. 


PROGRAMMING EXERCISES 


Exercise P17.1. Modity the generic Pair class so that both values have the same type. 


Exercise P17.2. Add a method swap to the Pair class of Exercise P17.1 that swaps the 
first and second elements of the pair. 


Exercise P17.3. Implement a static generic method PairUtil.swap whose parameter is 
a Pair object, using the generic class defined in Section 17.2. The method should 
return a new pair, with the first and second element swapped. 


Exercise P17.4. Write a static generic method PairUtil.minmax that computes the 
minimum and maximum elements of an array of type T and returns a pair contain- 
ing the minimum and maximum value. Require that the array elements implement 
the Measurable interface of Chapter 9. 


Exercise P17.5. Repeat the problem of Exercise P17.4, but require that the array ele- 
ments implement the Comparable interface. 


Exercise P17.6. Repeat the problem of Exercise P17.5, but refine the bound of the 
type variable to extend the generic Comparable type. 


Exercise P17.7. Implement a generic version of the binary search algorithm. 


Exercise P17.8. Implement a generic version of the merge sort algorithm. Your pro- 
gram should compile without warnings. 


Exercise P17.9. Implement a generic version of the BinarySearchTree class of 


Chapter 16. 


Exercise P17.10. ‘Turn the HashSet implementation of Chapter 16 into a generic class. 
Use an array list instead of an array to store the buckets. 


Exercise P17.11. Define suitable hashCode and equals methods for the Pair class of 
Section 17.2 and implement a HashMap class, using a HashSet<Pair<K, V>>. 


Exercise P1712. Implement a generic version of the permutation generator in 
Section 13.2. Generate all permutations of a List<E>. 


Exercise P1713. Write a generic static method print that prints the elements of any 
object that implements the Iterable<E> interface. The elements should be separated 
by commas. Place your method into an appropriate utility class. 


Additional programming exercises are available in WileyPLUS. 
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PROGRAMMING PROJECTS 


Project 17.1. Design and implement a generic version of the DataSet class of Chapter 
9 that can be used to analyze data of any class that implements the Measurable inter- 
face. Make the Measurable interface generic as well. Supply an addA11 method that 
lets you add all values from another data set with a compatible type. Supply a 
generic Measurer<T> interface to allow the analysis of data whose classes don’t 
implement the Measurable type. 


Project 17.2. Turn the PriorityQueue class of Chapter 16 into a generic class. As with 
the TreeSet class of the standard library, allow a Comparator to compare queue ele- 
ments. If no comparator is supplied, assume that the element type implements the 
Comparable interface. 


ANSWERS TO SELF-CHECK QUESTIONS 


. HashMap<String, Integer> 
. It uses inheritance. 


. new Pair<String, String>C"Hello", "World") 


m W NHN =z 


. ListIterator<E> is now a generic type. Its interface depends on the element 
type of the linked list. 


5. The output depends on the definition of the toString method in the Bank- 
Account class. 


6. No—the method has no type parameters. It is an ordinary method in a generic 
class. 


7. public class BinarySearchTree<E extends Comparable> 
8. public static <E extends Measurable> E min(E[] a) 


E smallest a[l0O]; 
for Cint 1 1; i < a. length; i++) 
if Cal[i].getMeasure() < smallest.getMeasure()) 
smallest = ali]; 
return smallest; 


} 
9. public static void print(Object[] a) 


for (Object e : a) 
System.out.print(e + " "); 
System.out.printInQ; 
} 


10. The LinkedList class of Chapter 15. 


Graphical 
User Interfaces § 


CHAPTER GOALS 


G To understand the use of layout managers to arrange 
user-interface components in a container 


G To become familiar with common user-interface components 
such as buttons, combo boxes, and menus 


G To build programs that handle events from 
user-interface components 


® To learn how to browse the Java documentation 


In this chapter, we will delve more deeply into graphical user interface 
programming. The graphical applications with which you are familiar have many 
visual gadgets for information entry: buttons, scroll bars, menus, etc. In this 
chapter, you will learn how to use the most common user-interface components in 
the Java Swing user-interface toolkit. Swing has many more components than can 
be mastered in a first course, and even the basic components have advanced options 
that can’t be covered here. In fact, few programmers try to learn everything about a 


particular user-interface component. It is more important to understand the 
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concepts and to search the Java documentation for the details. This chapter walks 


you through one example to show you how the Java documentation is organized 


and how you can rely on it for your programming. 


CHAPTER CONTENTS 


18.1G Layout Management 788 


18.2G Choices 790 


How To 18.1: Laying Out a User Interface 799 
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18.4G Exploring the Swing 
Documentation 808 


PRODUCTIVITY HINT 18.1: Use a GUI Builder 801 
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A ee Regt pe eee TRC ES Paar Ser al eer plighan eae eae yt eiye e es ; Halen os Sr seve paste = = SMH pe ee ea Fog : Se ee tg ee eS 


-User-interface components 
are arranged by placing © 
them: inside containers. 
Containers can be placed 
inside e larger containers. 


Each container has a 
- layout manager that 


directs the arrangement of 


‘its: components. me 


Three useful layout | 
managers are the border 
layout, flow layout, and | 

grid layout. 


When adding. a component 
toa container with the 


border layout, specify | the = 
_ NORTH, EAST, SOUTH, WEST, | 


or CENTER position. 


Up to now, you have had limited control over the layout of user- 
interface components. You learned how to add components to a 
panel. The panel arranged the components from the left to the right. 
However, in many applications, you need more sophisticated 
arrangements. 

In Java, you build up user interfaces by adding components into 
containers such as panels. Each container has its own layout man- 
ager, which determines how the components are laid out. 

By default, a JPanel uses a flow layout. A flow layout simply 
arranges its components from left to right and starts a new row when 
there is no more room in the current row. 

Another commonly used layout manager is the border layout. The 
border layout groups the container into five areas: center, north, 
west, south, and east (see Figure 1). Not all of the areas need to be 
occupied. 

The border layout is the default layout manager for a frame (or, 
more technically, the frame’s content pane). But you can also use the 
border layout in a panel: 


panel.setLayout(new BorderLayout()) ; 


Now the panel is controlled by a border layout, not the flow layout. 
When adding a component, you specify the position, like this: 


panel.add(component, BorderLayout.NORTH) ; 
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Center 


is corn aie The grid layout is a third layout that is sometimes useful. The grid 
frame has a border layout layout arranges components in a grid with a fixed number of rows 
by default. A panel has a and columns, resizing each of the components so that they all have 
flow layout by default. _—sthe same size. Like the border layout, it also expands each component 
tc fill the entire allotted area. (If that is not desirable, you need to 
place each component inside a panel.) Figure 2 shows a number pad 

panel that uses a grid layout. To create a grid layout, you supply the number of 

rows and columns in the constructor, then add the components, row by row, left to 


right: 


Figure 1 
Components Expand to Fill 
Space in the Border Layout 


JPanel buttonPanel = new JPanel(); 
buttonPanel.setLayout(new GridLayout(4, 3)); 
buttonPanel.add(button7) ; 
buttonPanel.add(button8s) ; 
buttonPanel.add(button9) ; 
buttonPanel.add(button4) ; 


Sometimes you want to have a tabular arrangement of the components where col- 
umns have different sizes or one component spans multiple columns. A more com- 
plex layout manager called the grid bag layout can handle these situations. The grid 
bag layout is quite complex to use, however, and we do not cover it in this book; 
see, for example, [1] for more information. Java 6 introduces a group layout that is 
designed for use by interactive tools—see Productivity Hint 18.1. 

Fortunately, you can create acceptable-looking layouts in nearly all situations by 
nesting panels. You give each panel an appropriate layout manager. Panels don’t 


Figure 2 The Grid Layout 
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Figure 3 Nesting Panels 


JTextkield 
in NORTH position 


JPanel 
with GridLayout 
5 6 in CENTER position 


3 H 
a 


have visible borders, so you can use as many panels as you need to organize your 
components. Figure 3 shows an example; the keypad from the ATM GUI in Chap- 
ter 12. The keypad buttons are contained in a panel with grid layout. That panel is 
itself contained in a larger panel with border layout. The text field is in the northern 
position of the larger panel. The following code produces this arrangement: 


JPanel keypadPanel = new JPanel(); 


keypadPanel 
buttonPanel 
buttonPanel 
buttonPanel 
buttonPane | 
7 ee 


keypadPanel. 


JTextField 
keypadPanel 


SELF CHECK 


1. How do you add two buttons to the north area of a frame? 


2. How can you stack three buttons on top of each other? 


.setLayout(new BorderLayout()); 

= new JPanel(); 

.setLayout(new GridLayout(4, 3)); 
.add(button7) ; 

.add(button8s) ; 


add(buttonPanel, BorderLayout.CENTER) ; 
display = new JTextField(); 
.add(display, BorderLayout.NORTH) ; 


For a small set of mutually 
exclusive choices, use a 
group of radio buttons or 
a combo box. 


In this section you will see how to present a finite set of choices to 
the user. If the choices are mutually exclusive, use a set of radio but- 
tons. In a radio button set, only one button can be selected at a time. 
When the user selects another button in the same set, the previously 
selected button is automatically turned off. (These buttons are called 


radio buttons because they work like the station selector buttons on a car radio: If 
you select a new station, the old station is automatically deselected.) For example, in 
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Figure 4, the font sizes are mutually exclusive. You can select small, medium, or 
large, but not a combination of them. 
To create a set of radio buttons, first create each button individu- 


Add radio buttons into a ally, and then add all buttons of the set to a ButtonGroup object: 


ButtonGroup so that only 
one button in the group is JRadioButton smal]Button = new JRadioButton("Smal1") ; 
JRadioButton mediumButton = new JRadioButton("Medium") ; 


on at any time. ° i 
JRadioButton largeButton = new JRadioButton("Large"); 


ButtonGroup group = new ButtonGroup(); 
group.add(smal1Button) ; 
group.add(mediumButton) ; 
group.add(largeButton) ; 


Note that the button group does not place the buttons close to each other on the 
container. The purpose of the button group is simply to find out which buttons to 
turn off when one of them is turned on. It is still your job to arrange the buttons on 
the screen. 

The isSelected method is called to find out whether a button is currently 
selected or not. For example, 


1f ClargeButton.isSelected(Q)) size = LARGE_SIZE; 


Call setSelected(true) on one of the radio buttons in a radio button group before 
making the enclosing frame visible. 

If you have multiple button groups, it is a good idea to group 
them together visually. You probably use panels to build up your 
user interface, but the panels themselves are invisible. You can add a 
border to a panel to make it visible. In Figure 4, for example; the panels 
containing the Size radio buttons and Style check boxes have borders. 


You can place a border 
around a panel to group 
its contents visually. 


@ FontViewer {EVE 


[| Bald 


Figure 4 
A Combo Box, Check Boxes, 
and Radio Buttons 
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There are a large number of border types. We will show only a couple of varia- 
tions and leave it to the border enthusiasts to look up the others in the Swing 
documentation. The EtchedBorder class yields a border with a three-dimensional, 
etched effect. You can add a border to any component, but most commonly you 
apply it to a panel: 

JPanel panel = new JPanel (); 

panel.setBorder(new EtchedBorder()) ; 

If you want to add a title to the border (as in Figure 4), you need to construct a 
TitledBorder. You make a titled border by supplying a basic border and then the 
title you want. Here is a typical example: 


panel.setBorder(new TitledBorder(new EtchedBorder(), "Size'")); 


A check box is a user-interface component with two states: checked 
and unchecked. You use a group of check boxes when one selection 
does not exclude another. For example, the choices for “Bold” and 
“Italic” in Figure 4 are not exclusive. You can choose either, both, or 
neither. Therefore, they are implemented as a set of separate check boxes. Radio 
buttons and check boxes have different visual appearances. Radio buttons are round 
and have a black dot when selected. Check boxes are square and have a check mark 
when selected. (Strictly speaking, the appearance depends on the chosen look and 
feel. It is possible to create a different look and feel in which check boxes have a dit- 
ferent shape or in which they give off a particular sound when selected.) 
You construct a check box by giving the name in the constructor: 


JCheckBox italicCheckBox = new JCheckBox("Italic"); 


For a binary choice, use a 
check box. | 


Do not place check boxes inside a button group. 


If you have a large number of choices, you don’t want to make a set 
of radio buttons, because that would take up a lot of space. Instead, 
you can use a combo box. This component is called a combo box 
because it is a combination of a list and a text field. The text field dis- 
plays the name of the current selection. When you click on the arrow to the right of 
the text field of a combo box, a list of selections drops down, and you can choose 
one of the items in the list (see Figure 5). 

If the combo box is editable, you can also type in your own selection. To make a 
combo box editable, call the setEditable method. 

You add strings to a combo box with the addItem method. 


For a large set of choices, 
use a combo box. ~ 


JComboBox facenameCombo = new JComboBox(); 
facenameCombo. addItem("Serif") ; 
facenameCombo. addItem("SansSerif") ; 
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Figure 5 
An Open Combo Box 


Monospaced 


You get the item that the user has selected by calling the getSelectedItem method. 
However, because combo boxes can store other objects in addition to strings, the 
getSelectedItem method has return type Object. Hence you must cast the returned 
value back to String. 


String selectedString 
= (String) facenameCombo.getSelectedItem() ; 


You can 1 select an item for the user with the setSelectedItem method. 

Radio buttons, check boxes, and combo boxes generate an Action- 
Event whenever the user selects an item. In the following program, we 
don’t care which component was clicked—all components notify the 
same listener object. Whenever the user clicks on any one of them, we 

es simply ask each component for its current content, using the isSelected 
atid getSelectedItem methods. We then redraw the text sample with the new font. 
Figure 6 shows how the components are arranged in the frame. Figure 7 shows 


the UML diagram. 


Radio buttons, check — 
boxes, and eee y 
generate action e events, 
justa as ; buttons do Se 


FA\FontViewer 


JLabel 
in CENTER position 


JPanel 
with GridLayout 
in SOUTH position 


{2 Small © Medium ®@ Large 


Figure 6 
The Components of the FontViewerFrame 
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Figure 7 


Classes of the Font Viewer Program 


ch18/choice/FontViewer.java 


1 


WA 
3 
4 
5 
6 
7 
8 


9 
10 
11 
2 
13 
14 


import javax.swing.JFrame; 


ate 
cay 


wk 


/ 


This program allows the user to view font effects. 


public class FontViewer 


! 


public static void main(String[] args) 


{ 


JFrame frame = new FontViewerFrame(); 
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
frame.setTitleC'FontViewer") ; 

frame.setVisible(true) ; 


GRAPHICS TRACK 


18.2 8 Choices GRAPHICS TRACK 795 


ch18/ choice/FontViewerFrame.java 


1 import java.awt.BorderLayout; 
2 import java.awt.Font; 
3 import java.awt.GridLayout; 
4 import java.awt.event.ActionEvent; 
5 import java.awt.event.ActionListener; 
6 import javax.swing.ButtonGroup; 
7 import javax.swing.JButton; 
8 import javax.swing. JCheckBox; 
9 import javax.swing.JComboBox; 
10 import javax.swing.JFrame; 
11 import javax.swing.JLabel; 
12 import javax.swing.JPanel; 
13 import javax.swing.JRadioButton; 
14 import javax.swing.border.EtchedBorder ; 
15 import javax.swing.border.TitledBorder; 


16 

17 a i 

18 This frame contains a text field and a control panel 
19 to change the font of the text. 

20 * 

21 public class FontViewerFrame extends JFrame 
ae | 

23 [er 

24 Constructs the frame. 

25 * / 

26 public FontViewerFrame() 

27 f 

28 // Construct text sample 

29 sampleField = new JLabel("Big Java"); 
30 add(sampleField, BorderLayout.CENTER) ; 
31 

32 // This listener is shared among all components 
33 class ChoiceListener implements ActionListener 
34 

35 public void actionPerformed(ActionEvent event) 
36 { 

37 setSampleFont() ; 

38 } 

39 } 

40 

41 listener = new ChoiceListenerQ ; 

42 

43 createControlPanel () ; 

a4, setSampleFont() ; 

45 setSize(FRAME_WIDTH, FRAME_HEIGHT) ; 

46 } 

47 

48 rials 

49 Creates the control panel to change the font. 
50 * 

51 public void createControlPanel © 


52 { 
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53 
54 
55 
56 
57 
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public JPanel createComboBox() 


{ 


ate 
wo 


public JPanel createCheckBoxes() 


{ 


# Graphical User Interfaces 


JPanel facenamePanel = createComboBox() ; 
JPanel sizeGroupPanel = createCheckBoxes() ; 
JPanel styleGroupPanel = createRadioButtons() ; 


// Line up component panels 

JPanel controlPanel = new JPanel(); 
contro|]Panel.setLayout(new GridLayout(3, 1)); 
controlPanel.add(facenamePanel) ; 

control Panel .add(sizeGroupPanel) ; 
controlPanel.add(styleGroupPanel) ; 

// Add panels to content pane 


add(controlPanel, BorderLayout. SOUTH) ; 


Creates the combo box with the font style choices. 


@return the panel containing the combo box 


facenameCombo = new JComboBox(); 
facenameCombo.addiItemC('Serif"); 
facenameCombo.addItem(''SansSerif"); 
facenameCombo.addIitem(''Monospaced"); 
facenameCombo.setEditable(true); 
facenameCombo.addActionListener(listener); 


JPanel panel = new JPanel(); 
panel.add(facenameCombo) ; 
return panel; 


Creates the check boxes for selecting bold and italic styles. 


@return the panel containing the check boxes 


italicCheckBox = new JCheckBox("Italic"); 
italicCheckBox.addActionListener(listener) ; 


boldCheckBox = new JCheckBox("'Bold"); 
boldCheckBox.addActionListener(listener) ; 


JPanel panel = new JPanel(); 
panel.add(italicCheckBox) ; 
panel .add(boldCheckBox) ; 
panel.setBorder( 
new TitledBorder(new EtchedBorder(), “Style")); 
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106 return panel; 

107 } 

108 

109 ae 

110 Creates the radio buttons to select the font size. 
111 @return the panel containing the radio buttons 
112 

113 public JPanel createRadioButtons() 

114 { 

115 smal1lButton = new JRadioButton("Smal1"); 
116 smal1lButton.addActionListener(listener) ; 
117 

118 mediumButton = new JRadioButton("Medium"); 
119 mediumButton.addActionListener(listener); 
120 

121 largeButton = new JRadioButton("Large"); 
122 largeButton.addActionListener(listener) ; 
123 largeButton.setSelected(true) ; 

124 

125 // Add radio buttons to button group 

126 

127 ButtonGroup group = new ButtonGroup() ; 
128 group.add(smal1Button) ; 

129 group.add(mediumButton) ; 

130 group.add(largeButton) ; 

131 

132 JPanel panel = new JPanel(); 

133 panel.add(smal1Button) ; 

134 panel.add(mediumButton) ; 

135 panel.add(largeButton) ; 

136 panel.setBorder ( 

137 new TitledBorder(new EtchedBorder(), "Size")); 
138 

139 return panel; 

140 } 

141 

142 ie 

143 Gets user choice for font name, style, and size 
144 and sets the font of the text sample. 

145 = 

146 public void setSampleFont() 

147 { 

148 // Get font name 

149 String facename 

150 = (String) facenameCombo.getSelectedItem( ; 
151 

152 // Get font style oe 
153 

154 int style = 0; 

155 if CitalicCheckBox.isSelected()) 

156 style = style + Font.ITALIC; 

157 if (boldCheckBox.isSelected()) 

158 style = style + Font.BOLD; 
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159 

160 // Get font size 

161 

162 int size = 0; 

163 

164 final int SMALL _SIZE = 24; 

165 final int MEDIUM_SIZE = 36; 

166 final int LARGE_SIZE = 48; 

167 

168 if (smal1Button.isSelected()) 

169 size = SMALL SIZE; 

170 else if (mediumButton.isSelected()) 
171 size = MEDIUM_SIZE; 

172 else if ClargeButton.isSelected()) 
173 size = LARGE SIZE; 

174 

175 // Set tont of text field 

176 

177 sampleField.setFont(new Font(facename, style, size)); 
178 sampleField.repaint(); 

179 ' 

180 

181 private JLabel sampleField; 

182 private JCheckBox italicCheckBox; 

183 private JCheckBox boldCheckBox; 

184 private JRadioButton smal1lButton; 

185 private JRadioButton mediumButton; 
186 private JRadioButton largeButton; 

187 private JComboBox facenameCombo; 

188 private ActionListener listener; 

189 

190 private static final int FRAME_WIDTH = 300; 
191 private static final int FRAME_HEIGHT = 400; 
192 } 

SELF CHECK 


3. What is the advantage of a JComboBox over a set of radio buttons? What is the 
disadvantage? 


4. Why do all user interface components in the FontViewerFrame class share the 
same listener? 


5. Why was the combo box placed inside a panel? What would have happened if it 
had been added directly to the control panel? 
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How To 18.1 


Laying Out a User Interface 


A graphical user interface is made up of components such as buttons and text fields. The 
Swing library uses containers and layout managers to arrange these components. This How 
To explains how to group components into containers and how to pick the right layout 
managers. 


Step 1. Make a sketch of your desired component layout. 


Draw all the buttons, labels, text fields, and borders on a sheet of paper. Graph paper works 
best. 
Here is an example—a user interface for ordering pizza. The user interface contains 


e Three radio buttons 

e ‘Two check boxes 

e A label: “Your Price:” 
e A text field 

e A border 


[| Pepperoni 


[x] Anchovies 


YourPrice: |__| 


Step 2. Find groupings of adjacent components with the same layout. 


Usually, the component arrangement is complex enough that you need to use several panels, 
each with its own layout manager. Start by looking at adjacent components that are arranged 
top to bottom or left to right. If several components are surrounded by a border, they should 
be grouped together. 

Here are the groupings from the pizza user interface: 


Size 


800 
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Step 3 Identify layouts for each group. 


When components are arranged horizontally, choose a flow layout. When components are 
arranged vertically, use a grid layout. The grid in this layout has as many rows as there are 
components, and it has one column. 

In the pizza user interface example, you would choose 


e A (3, 1) grid layout for the radio buttons 
e A (2, 1) grid layout for the check boxes 
e A flow layout for the label and text field 


Step 4 Group the groups together. 


Look at each group as one blob, and group the blobs together into larger groups, just as you 
grouped the components in the preceding step. If you note one large blob surrounded by 
smaller blobs, you can group them together in a border layout. 

You may have to repeat the grouping again if you have a very complex user interface. You 
are done if you have arranged all groups in a single container. 

For example, the three component groups of the pizza user interface can be arranged as 
follows: 


e A group containing the first two component groups, placed in the center of a container 
with a border layout 


e The third component group, in the southern area of that container 


in CENTER position 


In this step, you may run into a couple of complications. The group “blobs” tend to vary in 
size more than the individual components. If you place them inside a grid layout, the grid 
layout forces them all to be the same size. Also, you occasionally would like a component 
from one group to line up with a component from another group, but there is no way for 
you to communicate that intent to the layout managers. 

These problems can be overcome by using more sophisticated layout managers or imple- 
menting a custom layout manager. However, those techniques are beyond the scope of this 
book. Sometimes, you may want to start over with Step 1, using a component layout that is 
easier to manage. Or you can decide to live with minor imperfections of the layout. Don’t 
worry about achieving the perfect layout—after all, you are learning programming, not user- 
interface design. 


Step 5 Write the code to generate the layout. 


This step is straightforward but potentially tedious, especially if you have a large number of 
components. 

Start by constructing the components. Then construct a panel for each component group 
and set its layout manager if it is not a flow layout (the default for panels). Add a border to 
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the panel if required. Finally, add the components to the panel. Continue in this fashion until 
you reach the outermost containers, which you add to the frame. 
Here is an outline of the code required for the pizza user interface. 


JPanel radioButtonPanel = new JPanel(); 
radioButtonPanel.setLayout(new GridLayout(3, 1)); 
radioButton.setBorder( 

new TitledBorder(new EtchedBorder(), "Size")); 
radioButtonPanel.add(smal1Button) ; 
radioButtonPanel.add(mediumButton) ; 
radioButtonPanel.addClargeButton) ; 


JPanel checkBoxPanel = new JPanel(); 
checkBoxPanel.setLayout(new GridLayout(2, 1)); 
checkBoxPanel .add(pepperoniButtonQ) ) ; 
checkBoxPanel.add(anchoviesButton()) ; 


JPanel pricePanel = new JPanel(); // Uses FlowLayout 
pricePanel.add(new JLabel("Your Price:")); 
pricePanel.add(priceTextField) ; 


JPanel centerPanel = new JPanel(); // Uses FlowLayout 
centerPanel.add(radioButtonPane]) ; 
centerPanel .add(checkBoxPanel) ; 


// Frame uses BorderLayout by default 
add(centerPanel, BorderLayout.CENTER) ; 
add(pricePanel, BorderLayout.SOUTH) ; 


Of course, you also need to add event handlers to the components. That is the topic of 
How To 10.1. 


PRODUCTIVITY HINT 18.1 


Use a GUI Builder 


As you have seen, implementing even a simple graphical user interface in Java is quite 
tedious. You have to write a lot of code for constructing components, using layout managers, 
and providing event handlers. Most of the code is boring and repetitive. 

A GUI builder takes away much of the tedium. Most GUI builders help you in three 


ways: 


© You drag and drop components onto a panel. The GUI builder writes the layout manage- 
ment code for you. 


e You customize components with a dialog box, setting properties such as fonts, colors, 
text, and so on. The GUI builder writes the customization code for you. 


© You provide event handlers by picking the event to process and providing just the code 
snippet for the listener method. The GUI builder writes the boilerplate code for attaching 
a listener object. 
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Java 6 introduced GroupLayout, a powerful layout manager that was specifically designed to 
be used by GUI builders. The free NetBeans development environment, available from 
http: //netbeans.org, makes use of this layout manager—see Figure 8. 

If you need to build a complex user interface, you will find that learning to use a GUI 
builder is a very worthwhile investment. You will spend less time writing boring code, and 
you will have more fun designing your user interface and focusing on the functionality of 
your program. 


Click here to Drag cOmpOvents 
view generated from this palette 
sGunee code onto the form 
(Ganraneiaa > COC] aene Se eect Mle 
is i a i. «tes 9 Swing 
, Source | Design 22 £2 
| ET vet JLabel I jButton 
SA Uline fa} JTogaleButton B~ |\CheckBox 


‘eee _ + * 7 #— JRadioButton =" ButtonGrou 
© Small “| Pepperoni: Tee a e 


{> Medium 


¥| Anchovies 


c= |Combobox 


3 JTextField 


Fatt JList 
fej JTextArea 


() Large 


— |_| JPanel F4 JTabbedPane 


Your Prices [| amt |ScrollBar | JScroliPane 


% |ilenuBbar EA JPopupMenu 


The GroupLayout 

manages the components @ Propertse a 
on this form echien a C= 

background Cl] (239,238,228) ...| 

buttonGroup <none> wv (_.| 

Use this dialog to componentPopupMeny <none> wv [| 
edit component forit Dialog 12 Bold (| 
properties foreground @ (51,5151) [ell | 
mnemonic Leaf | 
selected iv| [|| +} 


Figure 8 A GUI Builder 
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a ontainsa menu *nyone who has ever used a graphical user interface is familiar with 
bar. Themenubar ——_——« Pull- down menus (see Figure 9). In Java it is easy to create these 


menus. 

The container for the top-level menu items is called a menu bar. A 
menu is a collection of menu items and more menus (submenus). You 
add menu items and submenus with the add method: 


Be ern ey ane ee ee NS 
contains menus. A menu — 


ay 


JMenuItem fileExitItem = new JMenultem("Exit"): 
fi leMenu.add(fileExitItem) ; 
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Menu bar 
File | Font. 
| 
haga | Menu 
_ ‘Size >| 
Style > Plain 
i  *Beld 
_ Fealic 
Bold italic | 
Menu item 


Figure 9 
Pull-Down Menus 


A menu item has no further submenus. When the user selects a menu 
item, the menu item sends an action event. Therefore, you want to 
add a listener to each menu item: 


fi leExitItem.addActionListener(listener) ; 


You add action listeners only to menu items, not to menus or the menu bar. When 
the user clicks on a menu name and a submenu opens, no action event is sent. 

The following program builds up a small but typical menu and traps the action 
events from the menu items. To keep the program readable, it is a good idea to use a 
separate method for each menu or set of related menus. Have a look at the create- 
FaceItem method, which creates a menu item to change the font face. The same lis- 
tener class takes care of three cases, with the name parameters varying for each menu 
item. The same strategy is used for the createSizeItem and createStyleItem methods. 


ch18/menu/FontViewer2.java 


import javax.swing.JFrame; 


xt 


This program uses a menu to display font effects. 


1 
Z 
3 
4 
5 % 
6 public class FontViewer2 
7 
8 
9 
10 


{ 
public static void main(String[] args) 
{ 
JFrame frame = new FontViewer2Frame() ; 
il frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
12 frame.setVisible(true); 
13 } 
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ch18/menu/FontViewer2Frame.java 


1 import java.awt.BorderLayout; 

2 import java.awt.Font; 

3 import java.awt.GridLayout; 

4 import java.awt.event.ActionEvent; 

5) ~=0 import java.awt.event.ActionListener; 
6 import javax.swing.ButtonGroup; 
7 
8 
9 
10 


import javax.swing.JButton; 
import javax.swing.JCheckBox; 
import javax.swing.JComboBox; 
import javax.swing.JFrame; 
11 import javax.swing.JLabel; 
12 import javax.swing.JMenu; 
13 import javax.swing.JMenuBar; 
14 import javax.swing.JMenultem; 
15 import javax.swing.JPanel; 
16 import javax.swing.JRadioButton; 
17 import javax.swing.border.EtchedBorder; 
18 import javax.swing.border.TitledBorder; 


19 
20 /** 
oo 21 This frame has a menu with commands to change the font 
_ 22 of a text sample. 
fees 23 * / 
24 public class FontViewer2Frame extends JFrame 
25 { 
26 [** 
27 Constructs the frame. 
28 a7 
29 public FontViewer2Frame() 
30 { 
31 // Construct text sample 
32 sampleField = new JLabel("Big Java"); 
33 add(sampleField, BorderLayout.CENTER) ; 
34 
35 // Construct menu 
36 JMenuBar menuBar = new JMenuBar(); 
37 setJMenuBar (menuBar) ; 
38 menuBar.add(createFi leMenu()); 
39 menuBar.add(createFontMenu()); 
40 
41 facename = "Serif": 
42 fontsize = 24; 
43 fontstyle = Font.PLAIN; 
44, 
45 setSampleFont(); 
46 setSize(FRAME_WIDTH, FRAME_HEIGHT) ; 
47 } 
48 
49 ee 
50 Creates the File menu. 
51 @return the menu 
52 af | 


53 public JMenu createFi 1leMenu() 
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54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
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JMenu menu = new JMenu("File"); 
menu.add(createFi leExitItemQ) ; 
return menu; 


Creates the File->Exit menu item and sets its action listener. 
@return the menu item 

a 

public JMenultem createFi leExitItem@ 

: 

JMenuItem item = new JMenulItem("Exit"); 

class MenultemListener implements ActionListener 


1 
public void actionPerformed(ActionEvent event) 
{ 
System.exit(0); 
5 
; 


ActionListener listener = new MenultemListenerQ() ; 
jtem.addActionListener(listener) ; 
return item; 


Creates the Font submenu. 
@return the menu 


public JMenu createFontMenu() 

{ 
JMenu menu = new JMenu("Font"); 
menu.add(createFaceMenu() ) ; 
menu.add(createSizeMenu() ) ; 
menu.add(createStyleMenu()) ; 
return menu; 


Creates the Face submenu. 
@return the menu 


public JMenu createFaceMenu() 


i 
JMenu menu = new JMenu("'Face'); 
menu.add(createFaceltem('Serif")); 
menu.add(createFaceltem('SansSerif")); 
menu.add(createFaceltem('Monospaced")); 
return menu; 

} 


Creates the Size submenu. 
@return the menu 


ale 
a 
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109 public JMenu createSizeMenu() 

110 { 

lil JMenu menu = new JMenu("Size"); 

112 menu.add(createSizeltem("Smaller", -1)); 

113 menu.add(createSizeltem("Larger", 1)); 

114 return menu: 

115 t 

116 

117 [** 

118 Creates the Style submenu. 

119 @return the menu 

120 * / 

121 public JMenu createStyleMenu() 

122 { 

123 JMenu menu = new JMenu("Style"); 

124 menu.add(createStyleItem("Plain", Font.PLAIN)); 
125 menu.add(createStyleItem("Bold", Font.BOLD)); 
126 menu.add(createStyleItem("Italic", Font. ITALIC)); 
127 menu.add(createStyleItem("Bold Italic", Font.BOLD 
128 + Font.ITALIC)); 

129 return menu; 

130 } 

131 

132 as 

133 Creates a menu item to change the font face and set its action listener. 
134 @param name the name of the font face 

135 @return the menu item 

136 yf 

137 public JMenuItem createFaceItem(final String name) 
138 { 

139 JMenuItem item = new JMenuItem(name) ; 

140 class MenultemListener implements ActionListener 
141 { 

142 public void actionPerformed(ActionEvent event) 
143 { 

144 facename = name; 

145 setSampleFont(); 

146 } 

147 } 

148 ActionListener listener = new MenuItemListener(); 
149 item.addActionListener(listener) ; 

150 return item: 

151 } 

152 

153 [** 

154 Creates a menu item to change the font size 

155 and set its action listener. 

156 @param name the name of the menu item 

157 @param ds the amount by which to change the size 

158 @return the menu item 

159 * / 

160 public JMenuItem createSizeItem(String name, final int ds) 
161 { 


162 JMenuItem item = new JMenuItem(name) ; 
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163 class MenuItemListener implements ActionListener 
164 { 

165 public void actionPerformed(ActionEvent event) 
166 { 

167 fontsize = fontsize + ds; 

168 setSampleFont() ; 

169 } 

170 } 

171 ActionListener listener = new MenultemListenerQ() ; 
172 item.addActionListener(listener) ; 

173 return item; 

174 } 

175 

176 [ee 

177 Creates a menu item to change the font style 

178 and set its action listener. 

179 @param name the name of the menu item 

180 @param style the new font style 

181 @return the menu item 

182 ay 

183 public JMenuItem createStyleItem(String name, final int style) 
184 { 

185 JMenuItem item = new JMenulItem(name) ; 

186 class MenultemListener implements ActionListener 
187 { 

188 public void actionPerformed(ActionEvent event) 
189 { 

190 fontstyle = style; 

191 setSampleFont() ; 

192 } 

193 } 

194 ActionListener listener = new MenultemListener(); 
195 item.addActionListener(listener) ; 

196 return item; 

197 } 

198 

199 ia 

200 Sets the font of the text sample. 

201 ef 

202 public void setSampleFont() 

203 4. 

204 Font f = new Font(facename, fontstyle, fontsize); 
205 sampleField.setFont (Ff) ; 

206 sampleField.repaintQ ; 

207 } 

208 

209 private JLabel sampleField; 

210 private String facename; 

211 private int fontstyle; 

212 private int fontsize; 

213 

214 private static final int FRAME_WIDTH = 300; 

215 private static final int FRAME_HEIGHT = 400; 


216 } 
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SELF CHECK 


6. Why do JMenu objects not generate action events? 
7. Why is the name parameter in the createFaceItem method declared as final? 


eae | 
QQ. 4 - fF .p 1Of] 
ses De caine emirates tele iene te kee 


You should learnto -—-—=S2 the preceding sections, you saw the basic properties of the most 
“navigate the AP! == = =~: Common user-interface components. We purposefully omitted many 
documentation to find out Options and variations to simplify the discussion. You can go a long 
more about user-interface way by using only the simplest properties of these components. If you 
want to implement a more sophisticated effect, you can look inside 
the Swing documentation. You will probably find the documentation 
quite intimidating at first glance, though. The purpose of this section is to show you 
how you can use the documentation to your advantage without becoming over- 
whelmed. 

Recall the Color class that was introduced in Chapter 2. Every combination of 
red, green, and blue values represents a different color. It should be fun to mix your 
own colors, with a slider for the red, green, and blue values (see Figure 10). 

The Swing user interface toolkit has a large set of user-interface components. 
How do you know if there is a slider? You can buy a book that illustrates all Swing 
components, such as [2]. Or you can run the sample application included in the Java 
Development Kit that shows off all Swing components (see Figure 11). Or you can 
look at the names of all of the classes that start with J and decide that JSlider may 
be a good candidate. 


_ more about 


Figure 10 
A Color Viewer 
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Figure 11 
The SwingSet 
Demo 


Next, you need to ask yourself a few questions: 


e How do I construct a JSlider? 
e How can I get notified when the user has moved it? 


© How can I tell to which value the user has set it? 


If you can answer these questions, then you can put a slider to good use. Once you 
have mastered sliders, you can fritter away more time and find out how to set tick 
marks or otherwise enhance the visual beauty of your creation. 

When you look at the documentation of the Jslider class, you will probably not 
be happy. There are over 50 methods in the JSlider class and over 250 inherited 
methods, and some of the method descriptions look downright scary, such as the 
one in Figure 12. Apparently some folks out there are concerned about the 
valueIsAdjusting property, whatever that may be, and the designers of this class felt 
it necessary to supply a method to tweak that property. Until you too feel that 
need, your best bet is to ignore this method. As the author of an introductory 
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Figure 12 A Mysterious Method Description from the AP! Documentation 


book, it pains me to tell you to ignore certain facts. But the truth of the matter is 
that the Java library is so large and complex that nobody understands it in its 
entirety, not even the designers of Java themselves. You need to develop the ability 
to separate fundamental concepts from ephemeral minutiae. For example, it is 
important that you understand the concept of event handling. Once you under- 
stand the concept, you can ask the question, “What event does the slider send when 
the user moves it?” But it is not important that you memorize how to set tick 
marks or that you know how to implement a slider with a custom look and feel. 

Let us go back to our fundamental questions. In Java 6, there are six constructors 
for the JSlider class. You want to learn about one or two of them. You must strike 
a balance somewhere between the trivial and the bizarre. Consider 


public JSliderQ 
Creates a horizontal slider with the range 0 to 100 and an initial value of 50. 


Maybe that is good enough for now, but what if you want another range or initial 
value? It seems too limited. 
On the other side of the spectrum, there is 


public JSlider(BoundedRangeModel brm) 
Creates a horizontal slider using the specified BoundedRangeModel. 


Whoa! What is that? You can click on the BoundedRangeModel link to get a long 
explanation of this class. This appears to be some internal mechanism for the Swing 
implementors. Let’s try to avoid this constructor if we can. Looking further, we find 


public JSliderCint min, int max, int value) 
Creates a horizontal slider using the specified min, max, and value. 


This sounds general enough to be useful and simple enough to be usable. You might 
want to stash away the fact that you can have vertical sliders as well. 
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Next, you want to know what events a slider generates. There is no addAction- 
Listener method. That makes sense. Adjusting a slider seems different from clicking 
a button, and Swing uses a different event type for these events. There is a method 


public void addChangeListener(ChangeListener 1) 


Click on the ChangeListener link to find out more about this interface. It has a sin- 


gle method 
void stateChanged(ChangeEvent e) 


Apparently, that method is called whenever the user moves the slider. What is a 
ChangeEvent? Once again, click on the link, to find out that this event class has no 
methods of its own, but it inherits the getSource method from its superclass Event- 
Object. The getSource method tells us which component generated this event, but 
we don’t need that information—we know that the event came from the slider. 

Now we have a plan: Add a change event listener to each slider. When the slider 
is changed, the stateChanged method is called. Find out the new value of the slider. 
Recompute the color value and repaint the color panel. That way, the color panel is 
continually repainted as the user moves one of the sliders. 

To compute the color value, you will still need to get the current value of the 
slider. Look at all the methods that start with get. Sure enough, you find 


public int getValue() 
Returns the slider’s value. 
Now you know everything you need to write the program. The program uses one 
new Swing component and one event listener of a new type. Of course, now that you 
have “tasted blood”, you may want to add those tick marks —see Exercise P18.10. 
Figure 13 shows how the components are arranged in the frame. Figure 14 shows 


the UML diagram. 


JPanel 
in CENTER position 


JPanel 
with GridLayout 


Figure 13 in SOUTH position 


The Components of 
the ColorViewerFrame 
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JFrame 


Figure 14 G@olomiicne) --------> oe pacers oe 
Classes of the Color rame 


Viewer Program 


ch18/slider/ColorViewer.java 


1 import javax.swing.JFrame; 


2 

3 public class ColorViewer 

4 { 

5 public static void main(String[] args) 

6 { 

7 ColorViewerFrame frame = new ColorViewerFrame(); 

8 frame.setDefaultCloseOperation(JFrame.EXIT_ON CLOSE); 
9 frame.setVisible(true) ; 
10 } 
11 } 


ch18/slider/ColorViewerFrame.java 


l import java.awt.BorderLayout; 

2 import java.awt.Color; 

3 import java.awt.GridLayout; 

4 import javax.swing.JFrame; 

5) =6import javax.swing.JLabel; 

6 import javax.swing.JPanel; 

7 import javax.swing.JSlider; 

8 import javax.swing.event.ChangeListener; 
9 import javax.swing.event.ChangeEvent; 


10 

11 public class ColorViewerFrame extends JFrame 
12 { 

13 public ColorViewerFrame() 

14 { 

15 colorPanel = new JPanel(); 

16 | 

17 add(colorPanel, BorderLayout.CENTER) ; 
18 createControlPanel(); 

19 setSampleColor(; 

20 setSize(FRAME_ WIDTH, FRAME HEIGHT); 
21 } 
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23 public void createControlPanel(Q) 
24 { 
25 class ColorListener implements ChangeListener 
26 1 
pai public void stateChanged(ChangeEvent event) 
28 if 
29 setSampleColor(); 
30 } 
31 } 
32 
33 ChangeListener listener = new ColorListener(); 
| 34 
| 35 redSlider = new JSlider(O, 255, 255); 
36 redSlider.addChangeListener(listener) ; 
37 
38 greenSlider = new JSlider(O, 255, 175); 
39 greenSlider.addChangeListener (listener) ; 
40 
4l blueSlider = new JSlider(O, 255, 175); 
42 blueSlider.addChangeListener(listener); 
43 
| Ad. JPanel controlPanel = new JPanel(); 
| 45 controlPanel.setLayout(new GridLayout(3, 2)); 
| 46 
47 controlPanel.add(new JLabel("'Red")); 
48 controlPanel.add(redSlider); 
49 
50 controlPanel.add(new JLabel("Green"));: 
51 controlPanel.add(CgreenSlider) ; 
52 
| 53 controlPanel.add(new JLabel("Blue")); 
| 54 controlPanel.add(blueSlider) ; 
55 
56 addCcontrolPanel, BorderLayout. SOUTH) ; 
57 + 
58 
59 Ww 
60 Reads the slider values and sets the panel to 
61 the selected color. 
62 * / 
63 public void setSampleColor() 
64 { 
65 // Read slider values 
66 
67 int red = redSlider.getValue(); 
| 68 int green = greenSlider.getValueQ) ; 
| 69 int blue = blueSlider.getValue(); 
70 
71 // Set panel background to selected color 
72 
73 colorPanel.setBackground(new Color(red, green, blue)); 
74 colorPanel.repaint(); 
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76 

77 private JPanel colorPanel; 

78 private JSlider redSlider; 

79 private JSlider greenSlider; 

80 private JSlider blueSlider; 

81 

82 private static final int FRAME_WIDTH = 300; 
83 private static final int FRAME_HEIGHT = 400; 
84 } 

SELF CHECK 


8. Suppose you want to allow users to pick a color from a color dialog box. Which 
class would you use? Look in the API documentation. 


9. Why does a slider emit change events and not action events? 


CHAPTER SUMMARY 


1. User-interface components are arranged by placing them inside containers. 
Containers can be placed inside larger containers. 


2. Each container has a layout manager that directs the arrangement of its 
components. 


3. Three useful layout managers are the border layout, flow layout, and grid 
layout. 


4. When adding a component to a container with the border layout, specify the 
NORTH, EAST, SOUTH, WEST, or CENTER position. 


5. The content pane of a frame has a border layout by default. A panel has a flow 
layout by default. 


6. For a small set of mutually exclusive choices, use a group of radio buttons or a 
combo box. 


7. Add radio buttons into a ButtonGroup so that only one button in the group is on 
at any time. 


8. You can place a border around a panel to group its contents visually. 
9. For a binary choice, use a check box. 
10. For a large set of choices, use a combo box. 


11. Radio buttons, check boxes, and combo boxes generate action events, just as 
buttons do. 
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12. A frame contains a menu bar. The menu bar contains menus. A menu contains 


13. 
14. 


submenus and menu items. 


Menu items generate action events. 


You should learn to navigate the API documentation to find out more about 


user-interface components. 


FURTHER READING 


1. Cay S. Horstmann and Gary Cornell, Core Java 2 Volume 1: Fundamentals, 7th edition, 


Prentice Hall, 2004. 


2. Kim Topley, Core Java Foundation Classes, 2nd edition, Prentice Hall, 2002. 


CLASSES, OBJECTS, AND METHODS 
INTRODUCED IN THIS CHAPTER 


java.awt.BorderLayout 

CENTER 

EAST 

NORTH 

SOUTH 

WEST 
java.awt.Container 

setLayout 
java.awt.FlowLayout 
java.awt.Font 
java.awt.GridLayout 
javax.swing.AbstractButton 

isSelected 

setSelected 
javax.swing.ButtonGroup 

add 
javax.swing.ImagelIcon 
javax.swing.JCheckBox 
javax.swing.JComboBox 

addiItem 

getSelectedItem 

isEditable 

setEditable 
javax.swing.JComponent 

setBorder 

setFont 


javax.swing.JFrame 

setjJMenuBar 
javax.swing.JMenu 

add 
javax.swing.JMenuBar 

add 
javax.swing.JMenultem 
javax.swing.JRadioButton 
javax.swing.JScrol1Pane 
javax.swing.JSlider 

addChangeListener 

getValue 
javax.swing.border.EtchedBorder 
javax.swing.border.TitledBorder 
javax.swing.event.ChangeEvent 
jJavax.swing.event.ChangeListener 

stateChanged 
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REVIEW EXERCISES 


Exercise R18.1. Can you use a flow layout for the components in a frame? If yes, how? 


Exercise R18.2. What is the advantage of a layout manager over telling the container 
“place this component at position (x, y)”? 


Exercise R18.3. What happens when you place a single button into the CENTER area of 
a container that uses a border layout? Try it out, by writing a small sample program, 
if you aren’t sure of the answer. 


Exercise R18.4. What happens if you place multiple buttons directly into the SOUTH 
area, without using a panel? Try it out, by writing a small sample program, if you 
aren’t sure of the answer. 


Exercise R18.5. What happens when you add a button to a container that uses a 
border layout and omit the position? Try it out and explain. 


Exercise R18.6. What happens when you try to add a button to another button? Try 
it out and explain. 


Exercise R18.7. The ColorViewerFrame uses a grid layout manager. Explain a draw- 


back of the grid that is apparent from Figure 13. What could you do to overcome 
this drawback? 


Exercise R18.8. What is the difference between the grid layout and the grid bag layout? 


Exercise R18.9. Can you add icons to check boxes, radio buttons, and combo boxes? 
Browse the Java documentation to find out. Then write a small test program to ver- 


ify your findings. 
Exercise R18.10. What is the difference between radio buttons and check boxes? 


Exercise R18.11. Why do you need a button group for radio buttons but not for 
check boxes? 


Exercise R18.12. What is the difference between a menu bar, a menu, and a menu item? 


Exercise R18.13. When browsing through the Java documentation for more informa- 
tion about sliders, we ignored the JSlider default constructor. Why? Would it have 
worked in our sample program? 


Exercise R18.14. How do you construct a vertical slider? Consult the Swing docu- 
mentation for an answer. 


Exercise R18.15. Why doesn’t a JComboBox send out change events? 


Exercise R18.16. What component would you use to show a set of choices, just as in 
a combo box, but so that several items are visible at the same time? Run the Swing 
demo app or look at a book with Swing example programs to find the answer. 


Exercise R18.17. How many Swing user interface components are there? Look at the 
Java documentation to get an approximate answer. 
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Exercise R18.18. How many methods does the JProgressBar component have? Be 
sure to count inherited methods. Look at the Java documentation. 


Additional review exercises are available in WileyPLUS. 


PROGRAMMING EXERCISES 


Exercise P18.1. Write an application with three buttons labeled “Red”, “Green”, and 
“Blue” that changes the background color of a panel in the center of the frame to 
red, green, or blue. 


Exercise P18.2. Add icons to the buttons of Exercise P18.1. 


Exercise P18.3. Write a calculator application. Use a grid layout to arrange buttons 
for the digits and for the + — x + operations. Add a text field to display the result. 


Exercise P18.4. Write an application with three radio buttons labeled “Red”, 
“Green”, and “Blue” that changes the background color of a panel in the center of 
the frame to red, green, or blue. 


Exercise P18.5. Write an application with three check boxes labeled “Red”, “Green”, 
and “Blue” that adds a red, green, or blue component to the the background color 
of a panel in the center of the frame. This application can display a total of eight 
color combinations. 


Exercise P18.6. Write an application with a combo box containing three items 
labeled “Red”, “Green”, and “Blue” that changes the background color of a panel 


in the center of the frame to red, green, or blue. 


Exercise P18.7. Write an application with a Color menu and menu items labeled 
“Red”, “Green”, and “Blue” that changes the background color of a panel in the 
center of the frame to red, green, or blue. 


Exercise P18.8. Write a program that displays a number of rectangles at random 
positions. Supply buttons “Fewer” and “More” that generate fewer or more ran- 
dom rectangles. Each time the user clicks on “Fewer”, the count should be halved. 
Each time the user clicks on “More”, the count should be doubled. 


Exercise P18.9. Modify the program of Exercise P18.8 to replace the buttons with a 
slider to generate fewer or more random rectangles. 


Exercise P18.10. In the slider test program, add a set of tick marks to each slider that 
show the exact slider position. 


Exercise P18.11. Enhance the font viewer program to allow the user to select differ- 
ent fonts. Research the API documentation to find out how to find the available 
fonts on the user’s system. 


Additional programming exercises are available in WileyPLUS. 
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PROGRAMMING PROJECTS 


Project 18.1. Write a program that lets users design charts such as the following: 


Golden Gate 


Brooklyn 


Delaware Memorial 


Mackinac 


Use appropriate components to ask for the length, label, and color, then apply them 
when the user clicks an “Add Item” button. Allow the user to switch between bar 
charts and pie charts. 


Project 18.2. Write a program that displays a scrolling message in a panel. Use a 
timer for the scrolling effect. In the timer’s action listener, move the starting position 
of the message and repaint. When the message has left the window, reset the starting 
position to the other corner. Provide a user interface to customize the message text, 
font, foreground and background colors, and the scrolling speed and direction. 


ANSWERS TO SELF-CHECK QUESTIONS 


1. First add them to a panel, then add the panel to the north end of a frame. 
2. Place them inside a panel with a GridLayout that has three rows and one column. 


3. If you have many options, a set of radio buttons takes up a large area. A combo 
box can show many options without using up much space. But the user cannot 
see the options as easily. 


4. When any of the component settings is changed, the program simply queries all 
of them and updates the label. 


5. To keep it from growing too large. It would have grown to the same width and 
height as the two panels below it. 


6. When you open a menu, you have not yet made a selection. Only JMenuItem 
objects correspond to selections. 


7. The parameter variable is accessed in a method of an inner class. 
8. JColorChooser. 


9. Action events describe one-time changes, such as button clicks. Change events 
describe continuous changes. 


Chapter 


Files and Streams 


CHAPTER GOALS 


® To become familiar with the concepts of text and binary formats 
® To learn about encryption 
® To understand when to use sequential and random file access 


® To be able to read and write objects using serialization 


In this chapter you will learn more about how to write Java programs that interact 
with disk files and other sources of bytes and characters. You will learn about text 
and binary formats, and about sequential and random access to the data in a file. We 
will discuss how you can use object serialization to save and load complex objects 
with very little effort. As an application of file processing, you will study a program 


for encrypting and decrypting sensitive data. 
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19.1 Text and Binary 
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There are two fundamentally different ways to store data: in text format or binary 
format. In text format, data items are represented in human-readable form, as a 
sequence of characters. For example, the integer 12,345 is stored as the sequence of 
five characters: 


i 1 ! 2 ! ! 3 ‘ 1 4 1 ' 5 i] 
In binary form, data items are represented in bytes. A byte is composed of 8 bits and 


can denote one of 256 values. For example, in binary format, the integer 12,345 1s 
stored as a sequence of four bytes. 


0 0 48 57 


(because 12,345 =48 - 256457). 

If you store information in text form, as a sequence of characters, 
you need to use the Reader and Writer classes and their subclasses to 
process input and output. If you store information in binary form, as 
a sequence of bytes, you use the InputStream and OutputStream classes 
and their subclasses. 

Text input and output are more convenient for humans, because it is easier to 
produce input (just use a text editor) and it is easier to check that output is correct 
(just look at the output file in an editor). However, binary storage is more compact 
and more efficient. 

To read text data from a disk file, you create a FileReader object: 


Streams access sequences 
= Of bytes. Readers and 
writers, access seduences 
: of characters. 


Use FileReader, 
FileWniter; 9-2 < 

FileInputStream, and To read binary data from a disk file, you create a FileInputStream 
Fi leOutputStreamclasses object instead: 

to read and write disk files. © 


FileReader reader = new FileReaderC"input.txt"); 


FileInputStream inputStream = 
new FileInputStreamC"input.bin"); 


Similarly, you use FileWriter and FileOutputStream objects to write data to a disk 
file in text or binary form respectively: 


FileWriter writer = new FileWriterC"output. txt"); 
FileOutputStream outputStream = new FileOutputStreamC"output.bin") ; 
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The read method returns” 

an integer, either - -1, at the 
end of the file, or another 
value, which you need to 

cast t toa a char ¢ or byte. 


Text and Binary Formats 


821 


The Reader class has a method, read, to read a single character at a 
time. (The FileReader class overrides this method to obtain the charac- 
ters from a disk file.) However, the read method actually returns an 
int so that it can signal either that a character has been read or that the 
end of input has been reached. At the end of input, read returns -1. 


Otherwise it returns the character (as an integer between 0 and 65,535). 
You Sead test the return value and, if it is not -1, cast it to a char: 


Reader reader =... .; 

Int next = reader.readQ) ; 

char c; 

Tt Nae != -1) 

= (char) next; 

The InputStream class also has a method, read, to read a single byte. The method 
also returns an int, namely either the byte that was input (as an integer between 0 
and 255) or the integer -1 if the end of the input stream has been reached. You 
should test the return value and, if it is not -1, cast it to a byte: 


InputStream in=.. .3 

int next = in.read(); 

byte b; 

1f (next != -1) 

= (byte) next; 
Similarly, the Writer and FileOutputStream classes have a write method to write a 
single character or byte. 

These basic methods are the only input and output methods that the file input 
and output classes provide. The Java stream package is built on the principle that 
each class should have a very focused responsibility. The job of a FileInputStream is 
to interact with files. Its job is to get bytes, not to ee them. If you want to read 
numbers, strings, or nee objects, you have to combine the class with other classes 
whose responsibility is to group individual bytes or characters together into num- 
bers, strings, and objects. You will see an example of those classes in Section 19.4. 


SELF CHECK 


1. Suppose you need to read an image file that contains color values for each pixel 
in the image. Will you use a Reader or an InputStream? 

2. Why do the read methods of the Reader and InputStream classes return an int 
and not a char or byte? 


COMMON ERROR 19.1 


Negative byte Values 


In Java, the byte type is a signed type. There are 256 values of the byte type, from —128 to 
127. The starting bit of the byte is the sign Dit. If it is on, the number is negative. In converting 
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an integer into a byte, only the least significant byte of the integer 1s taken, and the remaining 
bytes are ignored. The result can be negative even if the integer is positive. For example, 


int n = 233; // Binary 00000000 00000000 00000000 11101001 
byte b = (byte) n; // Binary 11101001, sign bit is on 
if (b == n).. . // Nottrue! b is negative, n is positive 


When the byte is converted back to an integer, then the result is still negative. In particular, it 
is different from the original. 
Here is an even trickier case. Consider this test: 


int next = in.read(); 

byte b = (byte) next; 

if (b == "é’) . ; 
This test is zever true, even if next was equal to the Unicode value for the 'é' character. That 
Unicode value happens to be 233, but a single byte is always a value between —128 and 127. 
American readers won’t be too concerned, because all characters and symbols used in Amer- 
ican English have Unicode values in the “safe” range between 1 and 127, but international 
programmers who use characters with Unicode values between 128 and 255 find this a 
source of continual frustration. 


An Encryption Program 


In this section, you will see a program that demonstrates typical file access tech- 
niques. The program encrypts a file—that is, scrambles it so that it is unreadable 
except to those who know the decryption method and the secret keyword. Ignoring 
over 2000 years of progress in the field of encryption, we will use a method familiar 
to Julius Caesar. The person performing any encryption chooses an encryption key; 
here the key is a number between 1 and 25 that indicates the shift to be used in 
encrypting each letter. For example, if the key is 3, replace A with D, B with E, and 
so on (see Figure 1). 

To decrypt, simply use the negative of the encryption key. For example, to 
decrypt the message of Figure 1, use a key of —3. 

In this program we process binary data—we read each byte separately, encrypt it, 
and write the encrypted byte. 


int next = in.readQ; 


if (next == -1) 
done = true; 
else 


byte b = (byte) next; 
byte c = encrypt(b) ; 
out.write(c); 


i 


In a more complex encryption program, you would read a block of bytes, encrypt 
the block, and write it out. 
Because the program reads binary data, it uses streams, not readers and writers. 
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Plaintext M ee t m e a t t hoe 
rryrrey etary eee 
Encryptedtext P h h w # p h # d w # wk h #- 


Figure 1 The Caesar Cipher 


Try out the program on a file of your choice. You will find that the encrypted file 
is unreadable. In fact, because the newline characters are transformed, you may not 
be able to read the encrypted file in a text editor. To decrypt, simply run the pro- 
gram again and supply the negative of the encryption key. 


ch19/caesar/CaesarCipher.java 


lL import java.io. InputStream; 
2 import java.io.OutputStream; 
3 import java.io.IOException; 
4 
5 ‘ 
6 This class encrypts files using the Caesar cipher. 
7 For decryption, use an encryptor whose key is the 
8 negative of the encryption key. 
g * 
10 public class CaesarCipher 
ll { 
12 i 
13 Constructs an cipher object with a given key. 
14 @param aKey the encryption key 
15 ry | 
16 public CaesarCipher(int aKey) 
17 { 
18 key = aKkey; 
19 , 
20 
2 l /% * 
22 Encrypts the contents of a stream. 
23 @param in the input stream 
24 @param out the output stream 
25 : 
26 public void encryptStream(InputStream in, OutputStream out) 
27 throws IOException 
28 { 
29 boolean done = false; 
30 while C!done) 
31 { 
32 int next = in.readQ; 
33 if (next == -1) done = true; 
34 else 
35 { 
36 byte b = (byte) next; 
37 byte c = encrypt(b); 
38 out.write(c); 
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41} 
a 


44 Encrypts a byte. 
@param b the byte to encrypt 
@return the encrypted byte 


ie 
49 { 
51 } 


48 public byte encrypt(byte b) 


return (byte) (b + key); 


53 private int key; 


ch19/caesar/CaesarEncryptor.java 


import 
import 
import 
import 
import 
import 
import 


7 seve 


* / 


15 { 


java.io.File; 
java.io.FileInputStream; 
java.io.FileOutputStream; 
java.io.InputStream; 
java.io. IOException; 
java.10.QOutputStream; 
java.util.Scanner; 


This program encrypts a file, using the Caesar cipher. 
public class CaesarEncryptor 


public static void main(String[] args) 


Scanner in = new Scanner(System.in); 
try 


{ 


System.out.printC"Input file: "); 
String inFile = in.nextQ; 
System.out.printC"Output file: "); 
String outFile = in.next(); 
System.out.printC"Encryption key: "); 
int key = in.nextIntQ; 


InputStream inStream = new FileInputStream(CinFi le); 
OutputStream outStream = new FileOutputStream(CoutFi le) ; 


CaesarCipher cipher = new CaesarCipher (key) ; 
Ccipher.encryptStreamCinStream, outStream) ; 


inStream.closeQ; 
outStream.close(); 
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35 catch (IOException exception) 

36 { 

37 System.out.printIn(C’Error processing file: " + exception); 
38 } 

39 - 

SELF CHECK 


3. Decrypt the following message: Khoor/#Zruog$. 


4. Can you use this program to encrypt a binary file, for example, an image file? 


RANDOM FACT 19.1 


Encryption Algorithms 


The exercises at the end of this chapter give a few algorithms to encrypt text. Don’t actually 
use any of those methods to send secret messages to your lover. Any skilled cryptographer 
can break those schemes in a very short time—that is, reconstruct the original text without 
knowing the secret keyword. 

In 1978 Ron Rivest, Adi Shamir, and Leonard Adleman introduced an encryption method 
that is much more powerful. The method is called RSA encryption, after the last names of its 
inventors. The exact scheme is too complicated to present here, but it is not difficult to fol- 
low. You can find the details in [1]. 

RSA is a remarkable encryption method. There are two keys: a public key and a private 
key. (See Public Key Encryption figure.) You can print the public key on your business card 
(or in your e-mail signature block) and give it to anyone. Then anyone can send you mes- 
sages that only you can decrypt. Even diguch everyone else knows the public key, and even 
if they intercept all the messages coming to you, they cannot break the scheme and actually 
read the messages. In 1994, ercles eros researchers, collaborating over the Internet, cracked 
an RSA message erected with a 129-digit key. Messages encrypted with a key of 230 digits 
or more are expected to be secure. 


Bob’s public key 


Xwya 
Txu% 
* (wt + - 
&93ya | 
=9 


Encrypted 
text 


Alice Bob 


Public Key Encryption 
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The inventors of the algorithm obtained a patent for it. That means that for a period of 20 
years, anyone using it had to seek a license from the inventors. They have given permission 
for most noncommercial usage, but companies that implemented RSA in a product that they 
sold had to get the patent holder’s permission and pay substantial royalties. The RSA patent 
expired on September 20, 2000, so you are now free to use the algorithm without restriction. 

A patent is a deal that society makes with an inventor. For a period of 20 years after the 
filing date, the inventor has an exclusive right for its commercialization, may collect royalties 
from others wishing to manufacture the invention, and may even stop competitors from 
marketing it altogether. In return, the inventor must publish the invention, so that others 
may learn from it, and must relinquish all claims to it after the protection period ends. The 
presumption is that, in the absence of patent law, inventors would be reluctant to go through 
the trouble of inventing, or they would try to cloak their techniques to prevent others from 
copying their devices. 

What do you think? Are patents a fair deal? Unquestionably, some companies have cho- 
sen not to implement RSA, and instead chose a less capable method, because they could not 
or would not pay the royalties. Thus, it seems that the patent may have hindered, rather than 
advanced, commerce. Had there not been patent protection, would the inventors have pub- 
lished the method anyway, thereby giving the benefit for society without the cost of the 20- 
year monopoly? In this case, the answer is probably yes; the inventors were academic 
researchers, who live on salaries rather than sales receipts and are usually rewarded for their 
discoveries by a boost in their reputation and careers. Would their followers have been as 
active in discovering (and patenting) improvements? There is no way of knowing. 

Further, is an algorithm even patentable in the first place? Or is it a mathematical fact that 
belongs to nobody? The patent office did take the latter attitude for a long time. The RSA 
inventors and many others described their inventions in terms of imaginary electronic 
devices, rather than algorithms, to circumvent that restriction. Nowadays, the patent office 
will award software patents. 

There is another fascinating aspect to the RSA story. A programmer named Phil Zimmer- 
mann developed a program called PGP (for Pretty Good Privacy) [2]. PGP implements RSA. 
That is, you can have it generate a pair of public and private keys, publish the public key, 
receive encrypted messages from others who use their copy of PGP and your public key, and 
decrypt them with your private key. Even though the encryption can be performed on any 
personal computer, decryption is not feasible even with the most powerful computers. You 
can get a copy of a free PGP implementation from the GNU project [3]. 

The existence of PGP bothers the government to no end. They worry that criminals use 
the package to correspond by e-mail and that the police cannot tap those “conversations”. 
Foreign governments can send communications that the National Security Agency (the pre- 
mier electronic spy organization of the United States) cannot decipher. In the 1990s, the USS. 
eovernment unsuccessfully attempted to standardize on a different encryption scheme, 
called Skipjack, to which government organizations hold a decryption key that—ot course— 
they promise not to use without a court order. There have been serious proposals to make it 
illegal to use any other encryption method in the United States. At one time, the government 
considered charging Zimmermann with breaching another law that torbids the unauthorized 
export of munitions as a crime and defines cryptographic technology as “munitions”. They 
made the argument that, even though Zimmermann never exported the program, he should 
have known that it would immediately spread through the Internet when he released it in the 
United States. 

What do you think? Will criminals and terrorists be harder to detect and convict once 
encryption of e-mail and phone conversations is widely available? Should the government 
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therefore have a backdoor key to any legal encryption method? Or is this a gross violation of 
our civil liberties? Is it even possible to put the genie back into the bottle at this time? 


1 9.3.R dN d om ACC 


hearers Srtagt Bete 


Reading a file sequentially from the beginning to the end can be inefficient. In this 
section, you will learn how to directly access arbitrary locations in a file. Consider a 
file that contains a set of bank accounts. We want to change the balances of some of 
the accounts. Of course, we can read all account data into an array list, update the 
information that has changed, and save the data out again. If the data set in the file 1s 
very large, we may end up doing a lot of reading and writing just to update a hand- 
ful of records. It would be better if we could locate the changed information in the 
file and just replace it. 

This is quite different from the file access you have programmed 
in Chapter 11, where you read from a file, starting at the beginning 
and reading the entire contents until you reached the end. That 
access pattern is called sequential access. Now we would like to 
locavoac inthe nic access specific locations in a file and change only those locations. 
without first reading the This access pattern is called random access (see Figure 2). There is 
bytes preceding the nothing “random” about random access—the term just means that 
access location. ~~~ youcanread and modify any byte stored at any location in the file. 

RRS SE Only disk files support random access; the System.in and System. out 

streams, which are attached to the keyboard and the terminal win- 

dow, do not. Each disk file has a special file pointer position. Normally, the file 

pointer is at the end of the file, and any output is appended to the end. However, if 

you move the file pointer to the middle of the file and write to the file, the output 

overwrites what is already there. The next read command starts reading input at the 

file pointer location. You can move the file pointer just beyond the last byte cur- 
rently in the file but no further. 

In Java, you use a RandomAccessFile object to access a file and move a file pointer. 
To open a random access file, you supply a file name and a string to specify the open 
mode. You can open a file pihertor reading only ("r") or for reading and writing 
("rw"). For example, the following command opens the file bank.dat for both read- 
ing and writing: 


In sequential file access, a 
file is processed one byte - 
at a time. Random access © 
allows. access at: arbitrary | 


RandomAccessFile f = new RandomAccessFileC"bank.dat", "“rw"); 


Sequential access 
NS ANS ANS ANE ANE ANE ANE NE ANE AS 


Random access 
Figure 2 a ee _ 


Sequential and Random Access 
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A file pointer is a position 
in a random access file. 
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The method call 
F.seek(n); 


moves the file pointer to byte n counted from the beginning of the file. To find out 
the current position of the file pointer (counted from the beginning of the file), use 


= f.getFilePointerQ ; 


Because files can be very large, the file pointer values are long integers. 
To determine the number of bytes in a file, use the length method: 


Because files can be very long fileLength = f.lengthQ); 


large, the file pointer is of 
type long. 


In the example program at the end of this section, we use a random 
access file to store a set of bank accounts, each of which has an account 
number and a current balance. The test program lets you pick an account and 
deposit money into it. 

If you want to manipulate a data set in a file, you have to pay special attention to 
the formatting of the data. Suppose you just store the data as text. Say account 1001 
has a balance of $900, and account 1015 has a balance of 0. 


10 0. f 9 0 0 1 0 1 5 0 


We want to deposit $100 into account 1001. Suppose we place the file pointer to the 
first character of the old value. 


10 02 


10 0 1 1 0 0 


That is not working too well. The update is overwriting the space that separates the 
fields. 

In order to be able to update values in a file, you must give each value a fixed size 
that is sufficiently large. As a result, every record in the file has the same size. This 
has another advantage: It is then easy to skip quickly to, say, the 50th record, with- 
out having to read the first 49 records in. Just set the file pointer to 49 x the record 
SIZ€. 

When storing numbers in a file with fixed record sizes, it is easier to store them in 
binary format, rather than text format. For that reason, the RandomAccessFile class 
stores binary data. The readInt and writeInt methods read and write integers as 
four-byte quantities. The readDouble and writeDouble methods process double- 
precision floating-point numbers as eight-byte quantities. 


double x = f.readDouble(); 
f.writeDouble (x); 
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If we save the account number as an integer and the balance as a double value, then 
each bank account record consists of 12 bytes: 4 bytes for the integer and 8 bytes for 
the double-precision floating-point value. 

Now that we have determined the file layout, we can implement our random 
access file methods. In the program at the end of this section, we use a BankData class 
to translate between the random access file format and bank account objects. The 
size method determines the total number of accounts by dividing the file length by 
the size of a record. 


public int size() throws IOException 


{ 
} 


To read the nth account in the file, the read method positions the file pointer to the 
offset n * RECORD_SIZE, then reads the data, and constructs a bank account object: 


return Cint) Cfile.lengthQ) / RECORD_SIZE); 


public BankAccount read(int n) 
throws IOException 


i 
file.seek(n * RECORD _SIZE); 
int accountNumber = file.readintQ; 
double balance = file.readDouble(); 
return new BankAccount(accountNumber, balance); 


: 
Writing an account works the same way: 


public void writeCint n, BankAccount account) 
throws IOException 


{ 
file.seek(n * RECORD_SIZE) ; 
file.writeInt(account.getAccountNumber()) ; 
file.writeDouble(account.getBalanceQ); 


: 


The test program asks the user to enter an account number and an amount to 
deposit. If the account does not currently exist, it is created. The money is depos- 
ited, and then the user can choose to continue or quit. The bank data are saved and 
reloaded when the program is run again. 


ch19/random/BankSimulator.java 


1 import java.io.IOException; 
2 import java.util.Scanner; 
3 
4 . 
5 This program demonstrates random access. You can access 
6 existing accounts and deposit money, or create new accounts. 
7 The accounts are saved in a random access file. 
8 * / 
9 public class BankSimulator 
10 { 
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11 public static void main(String[] args) 

12 throws IOException 

13 4 

14 Scanner in = new Scanner(System.in); 

15 BankData data = new BankData(); 

16 try 

17 { 

18 data.open("bank.dat"); 

19 

20 boolean done = false; 

21 while (!done) 

22 { 

23 System.out.print("Account number: "); 
24 int accountNumber = in.nextInt(); 

2> System.out.printC'Amount to deposit: "); 
26 double amount = in.nextDouble(); 

27 

28 int position = data. find(accountNumber) ; 
29 BankAccount account; 

30 if (position >= 0) 

31 { 

32 account = data.read(position); 

33 account.deposit(amount) ; 

34 System.out.printIn("New balance: " 
35 + account.getBalance()); 

36 } 

37 else // Add account 

38 { 

39 account = new BankAccount(accountNumber , 
40 amount) ; 

41 position = data.size(); 

42 System.out.printInC"Adding new account."); 
43 i; 

44 data.write(position, account); 

45 

46 System.out.print("Done? (Y/N) "); 

47 String input = in.nextQ; 

48 if Cinput.equalsIgnoreCase("Y")) done = true; 
49 } 

50 } 

51 finally 

52 { 

53 data.close(): 

54 } 

55 } 

56 } 


ch19/random/BankData.java 


lL import java.io.IOException; 
2 import java.io.RandomAccessFile; 


4 f* v 
5 This class is a conduit to a random access file 
6 containing savings account data. 
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ee 
8 public class BankData 
9 { 
10 i 
11 Constructs a BankData object that is not associated 
12 with a file. 
13 * / 
14 public BankData() 
15 : 
16 file = null; 
17 } 
18 
19 | ie 
20 Opens the data file. 
rat @param filename the name of the file containing savings 
£2 account information 
23 * 
24 public void open(String filename) 
25 throws IOException 
26 { 
27 if (file |= null): fileseloseQ: | 
28 file = new RandomAccessFile(filename, “rw"); 
29 } 
30 
31 [s* 
S2 Gets the number of accounts in the file. 
33 @return the number of accounts 
34 * / 
35 public int sizeQ) 
36 throws IOException 
37 i 
38 return Cint) (file.lengthQ / RECORD_SIZE); 
39 ; 
40 
4] oe 
42 Closes the data file. 
43 yy 
Ad, public void close() 
45 throws IOException 
46 { 
47 if (file != null) file.closeQ; 
48 file = null; 
49 5 
50 
51 we 
52 Reads a savings account record. 
53 @param n the index of the account in the data file 
54 @return a savings account object initialized with the file data 
55 my 
56 public BankAccount read(Cint n) 
57 throws IOException 
58 { 
59 file.seek(n * RECORD_SIZE); 
60 int accountNumber = file.readiIntQ; 
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61 double balance = file.readDouble(); 
62 return new BankAccount(CaccountNumber, balance); 
63 } 
64 
65 fee 
66 Finds the position of a bank account with a given number. 
67 @param accountNumber the number to find 
68 @return the position of the account with the given number, 
69 or —1 if there 1s no such account 
70 se 
71 public int findCint accountNumber) 
te throws IOException 
73 { 
74 for Cint i = 0; 1 < sizeQ); i++) 
75 { 
76 file.seek(i * RECORD SIZE); 
Ye 3 int a = file.readint(Q); 
78 if (a == accountNumber) // Found a match 
79 return 1; 
80 } 
81 return ~1; // No match in the entire file 
82 
83 
84 jf 
85 Writes a savings account record to the data file. 
86 @param n the index of the account in the data file 
87 @param account the account to write 
88 ay 
89 public void write(int n, BankAccount account) 
90 throws IOException 
91 i‘ 
92 file.seek(n * RECORD SIZE); 
93 file.writeInt(account.getAccountNumber()); 
94 file.writeDouble(account.getBalance()); 
95 } 
96 
97 private RandomAccessFile file; 
98 
99 public static final int INT_SIZE = 4; 
100 public static final int DOUBLE_SIZE = 8; 
101 public static final int RECORD_SIZE 
102 = INT_SIZE + DOUBLE _SIZE; 
103 } 
Output 


Account number: 1001 
Amount to deposit: 100 
Adding new account. 
Done? (Y/N) N 

Account number: 1018 
Amount to deposit: 200 
Adding new account. 
Done? (Y/N) N 


Use object streams to save 


and restore al 


fields of an object 
automatically. — 
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Account number: 1001 
Amount to deposit: 1000 
New balance: 1100.0 
Done? (Y/N) Y 


SELF CHECK 


5. Why doesn’t System.out support random access? 


6. What is the advantage of the binary format for storing numbers? What is the 
disadvantage? 


OE Boe cartes Sc ooen 


coat 


In the program of Section 19.3, you read BankAccount objects by reading each field 
value separately. Actually, there is an easier way. The ObjectOutputStream class can 
save entire objects out to disk, and the ObjectInputStream class can read them back 
in. Objects are saved in binary format; hence, you use streams and not writers. 

For example, you can write a BankAccount object to a file as follows: 


BankAccount b=. “3 

ObjectOutputStream out = new ObjectOutputStream( 
new FileOutputStream("bank.dat")) ; 

out.writeObject(b) ; 


The object output stream automatically saves all instance variables of 
the object to the stream. When reading the object back in, you use 
the readObject method of the ObjectInputStream class. That method 
returns an Object reference, so you need to remember the types of 
the objects that you saved and use a cast: 


| instance 


ObjectInputStream in = new ObjectInputStream( 
new FileInputStreamC"bank.dat")); 
BankAccount b = (BankAccount) in.readObjectQ); 


The readObject method can throw a ClassNotFoundException—it is a checked excep- 
tion, so you need to catch or declare it. 

You can do even better than that, though. You can store a whole bunch of objects 
in an array list or array, or inside another object, and then save that object: 


ArrayList<BankAccount> a = new ArrayList<BankAccount>() ; 
// Now add many BankAccount objects into a 
out.writeObject(a) ; 


With one instruction, you can save the array list and all the objects that it references. 
You can read all of them back with one instruction: 


ArrayList<BankAccount> a = (ArrayList<BankAccount>) in.readObjectQ) ; 


Of course, if the Bank class contains an ArrayList of bank accounts, then you can 
simply save and restore a Bank object. Then its array list, and all the BankAccount 
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Objects saved to an object 
stream must belong to 
classes that implement the 
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objects that it contains, are automatically saved and restored as well. The sample 
program at the end of this section uses this approach. 

This is a truly amazing capability that is highly recommended (see Productivity 
Hint 19.1). 

To place objects of a particular class into an object stream, the class 
must implement the Serializable interface. That interface has no 
methods, so there 1s no effort involved in implementing it: 


Serializable interface. class BankAccount implements Serializable 


{ 
$ 


The process of saving objects to a stream is called serialization because each object 
is assigned a serial number on the stream. If the same object is saved twice, only the 
serial number is written out the second time. When the objects are read back in, 
duplicate serial numbers are restored as references to the same object. 

Why don’t all classes implement Serializable? For security reasons, some pro- 
erammers may not want to serialize classes with confidential contents. Once a class 
is serializable, anyone can write its objects to disk and analyze the disk file. There are 
also some classes that contain values that are meaningless once a program exits, such 
as Operating-system-specific font descriptors. These values should not be serialized. 

Here is a sample program that puts serialization to work. The BankAccount and 
Bank classes are identical to those of Chapter 7, except that they both implement the 
Serializable interface. Run the program several times. Whenever the program 
exits, it saves the Bank object (and all bank account objects that the bank contains) 
into a file bank.dat. When the program starts again, the file is loaded, and the 
changes from the preceding program run are automatically reflected. However, if 
the file is missing (either because the program is running for the first time, or 
because the file was erased), then the program starts with a new bank. 


ch19/serial/SerialDemo.java 


lL import java.io.File; 

2 import java.io.IOException; 

3 import java.io.FileInputStream; 

4 import java.io.FileOutputStream; 

5 import java.io.ObjectInputStream; 
6 import java.io.ObjectOutputStream; 
ri 

8 


[** 

9 This program demonstrates serialization of a Bank object. 
10 If a file with serialized data exists, then it is loaded. 
11 Otherwise the program starts with a new bank. 
12 Bank accounts are added to the bank. Then the bank 
13 object is saved. 
14 */ 
15 public class SerialDemo 
16 { 
17 public static void main(String[] args) 


18 throws IOException, ClassNotFoundException 
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19 { 

20 Bank firstBankOfJava; 

21 

22 File f = new File("bank.dat"); 

23 if (f.existsQ) 

24 f 

25 ObjectInputStream in = new ObjectInputStream( 

26 new FileInputStream(f)); 

27 firstBankOfJava = (Bank) in.readObjectQ; 

28 in.close(); 

29 } 

30 else 

31 { 

32 firstBankOfJava = new Bank(); 

33 firstBankOfjJava.addAccount(new BankAccount(1001, 20000)); 
34 firstBankOfjJava.addAccount(new BankAccount(1015, 10000)); 
35 } 7 

36 

37 // Deposit some money 

38 BankAccount a = firstBankOfJava.find(1001); 

39 a.deposit(100); 

40 System.out.printIn(a.getAccountNumber() + ":" + a.getBalance()); 
41 a = firstBankOfJava.find(1015); 

42 System.out.printIn(a.getAccountNumber() + ":" + a.getBalance()); 
43 

44. ObjectOutputStream out = new ObjectOutputStream( 

45 new FileOutputStream(f)); 

46 out.writeObject(firstBankOfJava) ; 

47 out.close(); 

48 } 

49 }3 

Output 


1001: 20100.0 
1015710000,0 


Output (Second Program Run) 


1001: 20200.0 
1015-10000 ..0 


SELF CHECK 


7. Why is it easier to save an object with an ObjectOutputStream than a 
RandomAccessFile? | 

8. What do you have to do to the Coin class so that its objects can be saved in an 
ObjectOutputStream? 
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How To 19.1 


Using Files and Streams 


Suppose your program needs to process data in files. This How To walks you through the 
steps that are involved. 


Step 1 Select a data format. 


The most important question you need to ask yourself concerns the format to use for saving 
your data. 


e Does your program need to save and restore objects? Then use object streams. 


© Does your program manipulate text, such as a plain text files? Then use readers and 
writers. 


¢ Does your program manipulate binary data, such as image files or encrypted data? Then 
use binary streams. 


We don’t discuss random access files here because they are not commonly needed for student 
projects. If you need to have fast access to data, use a database. 


Step 2 If you use object streams, make your classes implement the Serializable interface. 


Simply go through your classes and tag them with implements Serializable. You don’t need 
to add any additional methods. 

Also go to the online API documentation to check that the library classes that you are 
using implement the Serializable interface. Fortunately, many of them do. In particular, 
String and ArrayList are serializable. 


Step 3. Use object streams if you are processing objects. 


Now simply put all the objects you want to save into a class (or an array or array list—but 
why not make another class containing that?). 
Saving all program data is a trivial operation: 


ProgramData data=.. .; 

ObjectOutputStream out = new ObjectOutputStream( 
new FileOutputStreamC"program.dat")); 

out.writeObject (data) ; 

out.close(); 


Similarly, to restore the program data, you use an ObjectInputStream and call 

ProgramData data = (ProgramData) in.readObject(); 
The readObject method can throw a ClassNotFoundException. You must catch or declare 
that exception. 


Step 4 Use readers and writers if you are processing text. 


Use a scanner to read the input. 
Scanner in = new Scanner(new FileReaderC"input.txt")); 


Then use the familiar methods next, nextInt, and so on. 
To write output, turn the file output stream into a PrintWriter: 


PrintWriter out = new PrintWriterC"output.txt"); 
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Then use the familiar print and printin methods: 


| out.printIn(text) ; 
| Step 5 Use streams if you are processing bytes. 


Use this loop to process input one byte at a time: 


InputStream in = new FileInputStreamC"input.bin") ; 
boolean done = false; 
while C!done) 


. 
int next = in.readQ; 
if (next = -1) 
done = true; 
else 
1 
byte b = (byte) next; 
Process input 
- 
} 


in.close(); 
Similarly, write the output one byte at a time: 


OutputStream out = new FileOutputStreamC"output.bin"); 


while (. . .) 

{ 
DYLEe Ds 2 « af 
out.write(b); 

} 


out.close(); 


Use binary streams only if you are ready to process the 1 input one byte at a time. This makes 
sense for encryption/decryption or processing the pixels in an image. In other situations, 
binary streams are not appropriate. 


| PRODUCTIVITY HINT 19.1 
Use Object Streams 


Object streams have a huge advantage over other data file formats. You don’t have to come 
up with a way of breaking objects up into numbers and strings when writing a file. You don’t 
have to come up with a way of combining numbers and strings back into objects when read- 
ing a file. The serialization mechanism takes care of this automatically. You simply write and 
read objects. For this to work, you need to have each of your classes implement the 
Serializable interface, which 1s trivial to do. 

To save your data to disk, it is best to put them all into one large object (such as an array 
list or an object that describes your entire program state) and save that object. When you 
need to read the data back, read that object back in. It is easier for you to retrieve data from 
an object than it is to search for them in a file. 
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CHAPTER SUMMARY 


. Streams access sequences of bytes. Readers and writers access sequences of 


characters. 


. Use FileReader, FileWriter, FileInputStream, and FileOutputStream classes to 


read and write disk files. 


. The read method returns an integer, either -1, at the end of the file, or another 


value, which you need to cast to a char or byte. 


. In sequential file access, a file is processed one byte at a time. Random access 


allows access at arbitrary locations in the file, without first reading the bytes pre- 
ceding the access location. 


. A file pointer is a position in a random access file. Because files can be very large, 


the file pointer is of type long. 


. Use object streams to save and restore all instance fields of an object 


automatically. 


. Objects saved to an object stream must belong to classes that implement the 


Serializable interface. 


CLASSES, OBJECTS, AND METHODS 
INTRODUCED IN THIS CHAPTER 


java.i0.FileInputStream java.10.RandomAccessFile 
java.io.FileOutputStream getFilePointer 
java.io.FileReader length 
java.io.FileWriter readChar 
java.io.InputStream readDouble 

close readint 

read seek 
java.io.0bjectInputStream writeChar 

readObject writeChars 
java.io.ObjectOutputStream writeDouble 

writeObject writeInt 
java.10.QOutputStream java.io.Reader 

close close 

write read 


jJava.io.Serializable 
java.io.Writer 

close 

write 


 o.4 


to 
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REVIEW EXERCISES 


Exercise R19.1. What is the difference between a stream and a reader? 
Exercise R19.2. How can you open a file for both reading and writing in Java? 


Exercise R19.3. What happens if you try to write to a file reader? What happens if 
you try to write to a random access file that you opened only for reading? Try it out 
if you don’t know. 


Exercise R19.4. How can you break the Caesar cipher? That is, how can you read a 
document that was encrypted with the Caesar cipher, even though you don’t know 
the key? 


Exercise R19.5. What happens if you try to save in an object stream an object that is 
not serializable? Try it out and report your results. 


Exercise R19.6. Of the classes in the java. lang and java.io packages that you have 
encountered in this book, which implement the Serializable interface? 


Exercise R19.7. Why is it better to save an entire ArrayList to an object stream 
instead of programming a loop that writes each element? 


Exercise R19.8. What is the difference between sequential access and random access? 


Exercise R19.9. What is the file pointer in a file? How do you move it? How do you 
tell the current position? Why is it a long integer? 


Exercise R19.10. How do you move the file pointer to the first byte of a file? To the 
last byte? To the exact middle of the file? 


Exercise R19.11. What happens if you try to move the file pointer past the end of a 
file? Can you move the file pointer of System. in? Try it out and report your results. 


Additional review exercises are available in WileyPLUS. 
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PROGRAMMING EXERCISES 


Exercise P19.1. Random monoalphabet cipher. The Caesar cipher, which shifts all let- 
ters by a fixed amount, is far too easy to crack. Here is a better idea. For the key, 
don’t use numbers but words. Suppose the key word is FEATHER. Then first remove 
duplicate letters, yielding FEATHR, and append the other letters of the alphabet in 
reverse order. Now encrypt the letters as follows: 


AB C DEF GHidg KEM NOP QRS 1 U VW XY Zz 
rye pe trees tet tree te ee eee te ed 
FEAT AHR ZY kK WY US 0 PON MLK J Lf GD € B 


Write a program that encrypts or decrypts a file using this cipher. The key word is 
specified with the -k command line option. The -d command line option specifies 
decryption. For example, 

java Encryptor -d -k FEATHER encrypt.txt output.txt 
decrypts a file using the keyword FEATHER. It is an error not to supply a keyword. 
Exercise P19.2. Letter frequencies. If you encrypt a file using the cipher of Exercise 
P19.1, it will have all of its letters jumbled up, and will look as if there is no hope of 
decrypting it without knowing the keyword. Guessing the keyword seems hope- 
less, too. There are just too many possible keywords. However, someone who is 
trained in decryption will be able to break this cipher in no time at all. The average 


letter frequencies of English letters are well known. The most common letter is E, 
which occurs about 13% of the time. Here are the average frequencies of the letters 


(see [4]). 


Toe EN: E% 
<1% 7% 3% WW. 2% 
3% <1% <A%: Xs al % 


H 4% 0 
I P 
J Q 
A% Kee Ro 8% YX 2% 
L S Z 
M T 
N U 


8% 


13% 4% 6% 
3% 3% 9% 
2% 8% 3% 


Go SHS Pid Ae GQ) Sede oe 


Write a program that reads an input file and prints the letter frequencies in that file. 
Such a tool will help a code breaker. If the most frequent letters in an encrypted file 
are H and K, then there is an excellent chance that they are the encryptions of E and T. 


Exercise P19.3. Vigenére cipher. The trouble with a monoalphabetic cipher is 
that it can be easily broken by frequency analysis. The so-called Vigenére cipher 
overcomes this problem by encoding a letter into one of several cipher letters, 


ww 
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depending on its position in the input document. Choose a keyword, for example 
TIGER. Then encode the first letter of the input text like this: 


AB € DE FE GH ES KEM NO PQ RS T UV WX YZ 
tryed t eet teeta te eae ete eae 
FoUV WX Y ZA B © DE FE GH EdJK LEM N OP QRS 


That is, the encoded alphabet is just the regular alphabet shifted to start at T, the first 
letter of the keyword TIGER. The second letter is encrypted according to the map 


A BC DEF GH EIJK EM N OP QRS FT UV WX YY Z 
rye ett e eer t ee teaae det beta eat 
rT JK EM N O© PQ RS TU V WX ¥ ZA BC DEE GH 


The third, fourth, and fifth letters in the input text are encrypted using the alphabet 
sequences beginning with characters G, E, and R. Because the key is only five letters 
long, the sixth letter of the input text is encrypted in the same way as the first. 


Write a program that encrypts or decrypts an input text according to this cipher. 
Use command line arguments as in Exercise P19.1. 


Exercise P19.4. Playfair cipher. Another way of thwarting a simple letter frequency 
analysis of an encrypted text is to encrypt pairs of letters together. A simple scheme 
to do this is the Playfair cipher. You pick a keyword and remove duplicate letters 
from it. Then you fill the keyword, and the remaining letters of the alphabet, into a 
5 x 5 square. (Because there are only 25 squares, I and J are considered the same let- 
ter.) Here is such an arrangement with the keyword PLAYFAIR: 


The encoding of this pair is formed by looking at the other two corners of the rect- 
angle—in this case, FQ. If both letters happen to be in the same row or column, such 
as GO, simply swap the two letters. Decryption is done in the same way. 


Write a program that encrypts or decrypts an input text according to this cipher. 
Use command line arguments as in Exercise P19.1. 


Exercise P19.5, Write a program that opens a binary file and prints all ASCII charac- 
ters from that file, that is, all bytes with values between 32 and 126. Print a new line 
after every 64 characters. What happens when you use your program with word 
processor documents? With Java class files? 
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Exercise P19.6. Modify the BankSimulator program so that it is possible to delete an 
account. To delete a record from the data file, fill the record with zeroes. 


Exercise P19.7. The data file in Exercise P19.6 may end up with many deleted records 
that take up space. Write a program that compacts such a file, moving all active 
records to the beginning and shortening the file length. Hint: Use the setLength 
method of the RandomAccessFile class to truncate the file length. Look up the 
method’s behavior in the API documentation. 


Exercise P19.8. Write a program that manipulates a database of product records. 
Records are stored in a binary file. Each record consists of these items: 

¢ Product name: 30 characters at two bytes each = 60 bytes 

e Price: one double = 8 bytes 

e¢ Quantity: one int = 8 bytes 
The program should allow the user to add a record, find a record that matches a 
product name, and change the price and quantity of a product by a given amount. 


Exercise P19.9. Enhance the SerialDemo program to demonstrate that it can save and 
restore a bank that contains a mixture of savings and checking accounts. 


Exercise P19.10. Implement a graphical user interface for the BankSimulator program 
in Section 19.3. 


Exercise P19.11. ‘This exercise is a continuation of Exercise P10.8. When the program 
starts, it should look to see whether a file is present that contains a serialized array 
of vehicles. If so, it redisplays them. Otherwise, it generates random vehicles, writes 
them to a file, and displays them. 


Additional programming exercises are available in WileyPLUS. 
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Project 19.1. Write a graphical application in which the user clicks on a panel to add 
shapes (rectangles, ellipses, cars, etc.) at the mouse click location. The shapes are 
stored in an array list. When the user selects File->Save from the menu, save the 
selection of shapes in a file. When the user selects File->Open, load in a file. Use 
serialization. 


Project 19.2. Write a toolkit that helps a cryptographer decrypt a file that was 
encrypted using a monoalphabet cipher. A monoalphabet cipher encrypts each 
character separately. Examples are the Caesar cipher and the cipher in Exercise 
P19.1. Analyze the letter frequencies as in Exercise P19.2. Use brute force to try all 
Caesar cipher keys, and check the output against a dictionary file. Allow the cryp- 
tographer to enter some substitutions and show the resulting text, with the 
unknown characters represented as ?. Try out your toolkit by decrypting files that 
you get from your classmates. 
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ANSWERS TO SELF-CHECK QUESTIONS 


1. 


Image data is stored in a binary format—try loading an image file into a text 
editor, and you won’t see much text. Therefore, you should use an InputStream. 


They return a special value of -1 to indicate that no more input is available. If 
the return type had been char or byte, no special value would have been avail- 
able that is distinguished from a legal data value. 


It is "Hello, World!", encrypted with a key of 3. 


. Yes—the program uses streams and encrypts each byte. 


5. Suppose you print something, and then you call seek(0), and print again to the 


same location. It would be difficult to reflect that behavior in the console window. 


Advantage: The numbers use a fixed amount of storage space, making it 
possible to change their values without affecting surrounding data. 
Disadvantage: You cannot read a binary file with a text editor. 

You can save the entire object with a single writeObject call. With a 
RandomAccessFile, you have to save each field separately. 


Add implements Serializable to the class definition. 


CHAPTER GOALS 


Multithreading j 


To understand how multiple threads can execute in parallel 
To learn how to implement threads 


To understand race conditions and deadlocks 


To be able to avoid corruption of shared objects by using locks 
and conditions 


To be able to use threads for programming animations 


lt is often useful for a program to carry out two or more tasks at the same time. For 
example, a web browser can load multiple images of a web page at the same time. 
Or an animation program can show moving figures, with separate tasks computing 
the positions of each separate figure. 

In this chapter, you will see how you can implement this behavior by running 
tasks in multiple threads, and how you can ensure that the tasks access shared data 


in a controlled fashion. 
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A thread is a program unit that is executed independently of other 
parts of the program. The Java virtual machine executes each thread 
for a short amount of time and then switches to another thread. 
This gives the illusion of executing the threads in parallel to each 

other. Actually, if a computer has multiple central processing units 
(CPUs), hen some of the threads can run in parallel, one on each processor. 
Running a thread is simple in Java—follow these steps: 


1. Implement a class that implements the Runnable interface. That interface has a 
single method called run: 


public interface Runnable 


{ 


$ 
2. Place the code for your task into the run method of your class. 


void run(); 


public class MyRunnable implements Runnable 


{ 


public void run() 


// Task statements go here 
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3. Create an object of your subclass. 
Runnable r = new MyRunnable(); 

4. Construct a Thread object from the runnable object. 
Thread t = new Thread(r); 

5. Call the start method to start the thread. 
t.starco : 


Let us look at a concrete example. We want to print ten greetings of 
“Hello, World!”, one greeting every second. We will add a time 
stamp to each greeting to see when it is printed. 


The start method of the 
Thread class starts a new 
thread that executes the 


run method of the Thu Dec 28 23:12:03 PST 2006 Hello, World! 
associated Runnable Thu Dec 28 23:12:04 PST 2006 Hello, World! 
object. Thu Dec 28 23:12:05 PST 2006 Hello, World! 


Thu Dec 28 23:12:06 PST 2006 Hello, World! 
Thu Dec 28 23:12:07 PST 2006 Hello, World! 
Thu Dec 28 23:12:08 PST 2006 Hello, World! 
Thu Dec 28 23:12:09 PST 2006 Hello, World! 
Thu Dec 28 23:12:10 PST 2006 Hello, World! 
Thu Dec 28 23:12:11 PST 2006 Hello, World! 
Thu Dec 28 23:12:12 PST 2006 Hello, World! 


Using the instructions for creating a thread, define a class that implements the 
Runnable interface: 


public class GreetingRunnable implements Runnable 


{ 
public GreetingRunnable(String aGreeting) 


{ 
} 


greeting = aGreeting; 


public void run() 


// Task statements go here 


} 

// Fields used by the task statements 

private String greeting; 

| } 

The run method should loop ten times through the following task actions: 

e Print a time stamp. 

e Print the greeting. 

e Wait a second. 

Get the time stamp by constructing an object of the java.util.Date class. Its default 
constructor produces a date that is set to the current date and time. 


Date now = new Date(); 
System.out.printInCnow + 


+ greeting); 
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The sleep method puts 


the current thread to sleep | 


for a given. number of 
milliseconds. as, 


ommot ‘response. is to 


terminate the. run method. | 
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To wait a second, we use the static sleep method of the Thread class. 


The call 


Thread.sleep (milliseconds) 


puts the current thread to sleep for a given number of milliseconds. 
In our case, it should sleep for 1,000 milliseconds, or one second. 
There is, however, one technical problem. Putting a thread to sleep 
is potentially risky—a thread might sleep for so long that it 1s no 
longer useful and should be terminated. As you will see in Section 
20.2, to terminate a thread, you interrupt it. When a sleeping thread 
is interrupted, an InterruptedException is generated. You need to 
catch that exception in your run method and terminate the thread. 


The simplest way to handle thread interruptions is to give your run method the fol- 


lowing form: 


public void run() 


Task statements 


catch (InterruptedException exception) 


Clean up, if necessary 


{ 
try 
} 

} 


We follow that structure in our example. Here is the complete code for the runnable 


class: 


ch20/greeting/GreetingRunnable.java 


1 import java.util.Date; 


A runnable that repeatedly prints a greeting. 
public class GreetingRunnable implements Runnable 
Constructs the runnable object. 
@param aGreeting the greeting to display 
public GreetingRunnable(String aGreeting) 


greeting = aGreeting; 


17 public void run() 


2 

3 / 

4 

5 

6 

7 { 

8 [x 

9 
10 
11 */ 
12 
13 f 
14 
15 } 
16 
18 f 
19 


try 
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21 for (int i = 1; i <= REPETITIONS; i++) 
Zz. { 

23 Date now = new Date(); 

24 System.out.printIn(now + " " + greeting); 
25 Thread.sleep (DELAY) ; 

26 } 

27 } 

28 catch (InterruptedException exception) 
29 { 

30 } 

31 } 

32 

33 private String greeting; 

34 

35 private static final int REPETITIONS = 10; 
36 private static final int DELAY = 1000: 

37 } 


To start a thread, first construct an object of the runnable class. 
Runnable r = new GreetingRunnableC"Hello, World!"); 
Then construct a thread and call the start method. 


Thread t = new Thread(r); 
t.startQd; 
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Now a new thread is started, executing the code in the run method of your runnable 


in parallel with any other threads in your program. 


In the GreetingThreadRunner program, we start two threads: one that prints 


“Hello, World!” and one that prints “Goodbye, World!” 


ch20/greeting/GreetingThreadRunner.java 


This program runs two greeting threads in parallel. 


1 

2 

3 

4 public class GreetinglhreadRunner 
a 
6 

7 

8 

9 


public static void main(String[] args) 


{ 
GreetingRunnable rl = new GreetingRunnable('Hello, World!"); 
GreetingRunnable r2 = new GreetingRunnable(''Goodbye, World!"); 
10 Thread t1 = new Thread(r1); 
11 Thread t2 = new Thread(r2); 
12 €L.srart) ; 
13 £2.starrO): 
14 } 
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Output 


Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 
Tue Dec 19 


The thread scheduler runs 
each thread for a short 
amount of time, called a. 
athimesslICeseeenrs cee! 
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12:04:46 PST 2006 Hello, World! 
12:04:46 PST 2006 Goodbye, World! 
12:04:47 PST 2006 Hello, World! 
12:04:47 PST 2006 Goodbye, World! 
12:04:48 PST 2006 Hello, World! 
12:04:48 PST 2006 Goodbye, World! 
12:04:49 PST 2006 Hello, World! 
12:04:49 PST 2006 Goodbye, World! 
12:04:50 PST 2006 Hello, World! 
12:04:50 PST 2006 Goodbye, World! 
12:04:51 PST 2006 Hello, World! 
12:04:51 PST 2006 Goodbye, World! 
12:04:52 PST 2006 Goodbye, World! 
12:04:52 PST 2006 Hello, World! 
12:04:53 PST 2006 Hello, World! 
12:04:53 PST 2006 Goodbye, World! 
12:04:54 PST 2006 Hello, World! 
12:04:54 PST 2006 Goodbye, World! 
12:04:55 PST 2006 Hello, World! 
12:04:55 PST 2006 Goodbye, World! 


Because both threads are running in parallel, the two message sets are 
interleaved. However, if you look closely, you will find that the two 
threads aren’t exactly interleaved. Sometimes, the second thread 
seems to jump ahead of the first thread. This shows an important 
characteristic of threads. The thread scheduler gives no guarantee 
about the order in which threads are executed. Each thread runs for a 


short amount of time, called a time slice. Then the scheduler activates another 
thread. However, there will always be slight variations in running times, especially 
when calling operating system services (such as input and output). Thus, you 
should expect that the order in which each thread gains control is somewhat 


random. 


SELF CHECK 


1. What happens if you change the call to the sleep method in the run method to 
Thread.sleep(1) ? 


2. What would be the result of the program if the main method called 


rl.run€): 
r2.run(); 


instead of starting threads? 
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QUALITY Tip 20.1 


Use the Runnable Interface 


In Java, you can define the task statements of a thread in two ways. As you have seen already, 
you can place the statements into the run method of a class that implements the Runnable 
interface. Then you use an object of that class to construct a Thread object. You can also form 
a subclass of the Thread class, and place the task statements into the run method of your 
subclass: 


public class MyThread extends Thread 


i 
public void run() 
t 
// ‘Task statements go here 
} 
} 


Then you construct an object of the subclass and call the start method: 


Thread t = new MyThread(); 
t.startQd; 


This approach is marginally easier than using a Runnable, and it also seems quite intuitive. 
However, if a program needs a large number of threads, or if a program executes in a resource- 
constrained device, such as a cell phone, it can be quite expensive to construct a separate thread 
for each task. Advanced Topic 20.1 shows how to use a thread pool to overcome this problem. 
A thread pool uses a small number of threads to execute a larger number of runnables. 

The Runnable interface is designed to encapsulate the concept of a sequence of statements 
that can run in parallel with other tasks, without equating it with the concept of a thread, a 
potentially expensive resource that is managed by the operating system. 


ADVANCED TOPIC 20.1 


Thread Pools 


A program that creates a huge number of short-lived threads can be inefficient. Threads are 
managed by the operating system, and there is a space and run-time cost for each thread that 
is created. This cost can be reduced by using a thread pool. A thread pool creates a number of 
threads and keeps them alive. When you add a Runnable object to the thread pool, the next 
idle thread executes its run method. 

For example, the following statements submit two runnables to a thread pool: 


Runnable rl = new GreetingRunnableC("Hello, World!"); 

Runnable r2 = new GreetingRunnable("Goodbye, World!"); 
ExecutorService pool = Executors.newFixedThreadPool (MAX_THREADS) ; 
pool.execute(r1) ; 

pool.execute(r2) ; 


If many runnables are submitted for execution, then the pool may not have enough threads 
available. In that case, some runnables are placed in a queue until a thread is idle. As a result, 
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the cost of creating threads is minimized. However, the runnables that are run by a particu- 
lar thread are executed sequentially, not in parallel. 

Thread pools are particularly important for server programs, such as database and web 
servers, that repeatedly execute requests from multiple clients. Rather than spawning a new 
thread for each request, the requests are implemented as runnable objects and submitted to a 
thread pool. 


VAR eS 


A thread terminates when 
its run method terminates. 


The run method can check 
whether its thread has 


A thread terminates when the run method of the associated runnable 
object returns. This is the normal way of terminating a thread— 
implement the run method so that it returns when it determines that 
no more work needs to be done. 

However, sometimes you need to terminate a running thread. For example, you 
may have several threads try to find a solution to a problem. As soon as the first one 
has succeeded, you may want to terminate the other ones. In the initial release of 
the Java library, the Thread class had a stop method to terminate a thread. However, 
that method is now deprecated—computer scientists have found that stopping a 
thread can lead to dangerous situations when multiple threads share objects. (We 
will discuss access to shared objects in Section 20.3.) Instead of simply stopping a 
thread, you should notify the thread that it should be terminated. The thread needs 
to cooperate, by releasing any resources that it is currently using and doing any 
other required cleanup. In other words, a thread should be in charge of terminating 
itself. 

To notify a thread that it should clean up and terminate, you use the interrupt 
method. 


t.interruptQ ; 


This method does not actually cause the thread to terminate—it 
merely sets a boolean field in the thread data structure. 


been interrupted by calling The run method can check whether that flag has been set, by calling 
the interrupted method. the static interrupted method. In that case, it should do any neces- 


sary cleanup and exit. For example, the run method of the Greeting- 
Runnable could check for interruptions at the beginning of each loop iteration: 


public void run() 
| 
for Cint 7 = 1; 
7 <= REPETITIONS && ! Thread. interruptedQ; 


1++) 
{ 
Do work 
; 
Clean up 
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However, if a thread is sleeping, it can’t execute code that checks for interruptions. 
Therefore, the sleep method is terminated with an InterruptedException whenever 
a sleeping thread is interrupted. The sleep method also throws an Interrupted- 
Exception when it 1s called in a thread that is already interrupted. If your run 
method calls sleep in each loop iteration, simply use the InterruptedException to 
find out whether the thread is terminated. The easiest way to do that is to surround 
the entire work portion of the run method with a try block, like this: 


public void run() 


i 
try 
{ 
for (int 71 = 1; 71 <= REPETITIONS; i++) 
Do work 
} 
; 
catch (InterruptedException exception) 
{ 
: 
Clean up 
i 


Strictly speaking, there is nothing in the Java language specification that says that a 
thread must terminate when it is interrupted. It is entirely up to the thread what it 
does when it is interrupted. Interrupting is a general mechanism for getting the 
thread’s attention, even when it is sleeping. However, in this chapter, we will always 
terminate a thread that is being interrupted. 


SELF CHECK 


3. Suppose a web browser uses multiple threads to load the images on a web page. 
Why should these threads be terminated when the user hits the “Back” button? 


4. Consider the following runnable. 


public class MyRunnable implements Runnable 


{ 


public void run() 


{ 
try 


{ 
System.out.printIn(1) ; 
Thread.sleep C1000) ; 
System.out.printIn(2); 
f 


catch (InterruptedException exception) 


{ 


} 
System.out.print|n(4) ; 


System.out.printIn(3); 
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Suppose a thread with this runnable is started and immediately interrupted. 


Thread t = new Thread(new MyRunnable()) ; 
t.startQd; 
£.1interruptdQ ; 


What output is produced? 


QUALITY TIP 20.2 
Check for Thread Interruptions in the run Method of a Thread 


By convention, a thread should terminate itself (or at least act in some other well-defined 
way) when it is interrupted. You should implement your threads to follow this convention. 

Simply put the thread action inside a try block that catches the InterruptedException. 
That exception occurs when your thread is interrupted while it is not running, for example 
inside a call to sleep. When you catch the exception, do any required cleanup and exit the 
run method. 

Some programmers don’t understand the purpose of the InterruptedException and, out 
of ignorance and desperation, muzzle it by surrounding only the call to sleep inside a try 


block. 


public void run() 


{ 
while (. . .) 
i 
try 
4 
Thread.sleep (delay) ; 
t 
catch (InterruptedException exception) {} // DON’T 
J 
} 


Don’t do that. If you do, users of your thread class can’t get your thread’s attention by inter- 
rupting it. It is just as easy to place the entire thread action inside a single try block. Then 
interrupting the thread terminates the thread action. 


public void run() 


{ 

try 

{ 
while (. . .) 
{ 

Th — .sleep (delay) ; 

} 

} 


catch (InterruptedException exception) {} // OK 


pe RE A el Dt I we tees Seer nit 
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When threads share access to a common object, they can conflict with each other. 
To demonstrate the problems that can arise, we will investigate a sample program in 
which multiple threads manipulate a bank account. 

We construct a bank account that starts out with a zero balance. We create two 
sets of threads: 


e Each thread in the first set repeatedly deposits $100. 
e Each thread in the second set repeatedly withdraws $100. 


Here is the run method of the DepositRunnable class: 


public void run() 


‘ 
try 
{ 
for (int 40 =) 15 4 = coupe: 144) 
{ 
account.deposit(Camount) ; 
Thread.sleep (DELAY) ; 
} 
} 
catch (InterruptedException exception) 
{ 
} 
} 


The WithdrawRunnab1e class is similar—it withdraws money instead. 

The deposit and withdraw methods of the BankAccount class have been modified 
to print messages that show what is happening. For example, here is the code for the 
deposit method: 


public void deposit(double amount) 


{ 
System.out.printC"Depositing " + amount); 
double newBalance = balance + amount; 
System.out.printIn(", new balance is " + newBalance); 
balance = newBalance; 

} 


You can find the complete source code at the end of this section. 
Normally, the program output looks somewhat like this: 


Depositing 100.0, new balance is 100.0 
Withdrawing 100.0, new balance is 0.0 
Depositing 100.0, new balance is 100.0 
Depositing 100.0, new balance is 200.0 
Withdrawing 100.0, new balance is 100.0 


Withdrawing 100.0, new balance is 0.0 
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In the end, the balance should be zero. However, when you run this program 
repeatedly, you may sometimes notice messed-up output, like this: 

Depositing 100.0Withdrawing 100.0, new balance is 100.0 

, new balance is -100.0 
And if you look at the last line of the output, you will notice that the final balance 1s 
not always zero. Clearly, something problematic 1s happening. 

You may have to try the program several times to see this effect. 

Here is a scenario that explains how a problem can occur. 


1. A deposit thread executes the lines 


iW 


System.out.print("Depositing " + amount) ; 

double newBalance = balance + amount; 
in the deposit method of the BankAccount class. The value of the balance field 
is still 0, and the value of the newBalance local variable is 100. 


2. Immediately afterwards, the deposit thread reaches the end of its time slice, 
and the second thread gains control. 


3. A withdraw thread calls the withdraw method, which prints a message and 
withdraws $100 from the balance variable. It is now —100. 


4. The withdraw thread goes to sleep. 


5. The deposit thread regains control and picks up where it was interrupted. It 
now executes the lines 


System.out.printIn(", new balance 1s + newBalance); 


balance = newBalance; 


The value of balance is now 100 (see Figure 1). 


Thus, not only are the messages interleaved, but the balance is wrong. The balance 
after a withdrawal and deposit should again be 0, not 100. Because the deposit 
method was interrupted, it used the old balance (before the withdrawal) to compute 
the value of its local newBalance variable. Later, when it was activated again, it used 
that newBalance value to overwrite the changed balance field. 

As you can see, each thread has its own local variables, but all 


A race condition occurs if threads share access to the balance instance field. That shared access 


the effect of multiple 
threads on shared data 
depends on the order in 
which the threads are 


scheduled. 


creates a problem. This problem is often called a race condition. All 
threads, in their race to complete their respective tasks, manipulate a 
shared field, and the end result depends on which of them happens to 
win the race. 

You might argue that the reason for this problem is that we made 
it too easy to interrupt the balance computation. Suppose the code 
for the deposit method is reorganized like this: 


public void deposit(double amount) 
{ 
balance = balance + amount; 
System.out.printC'Depositing 


W 


+ amount 
+ balance) ; 


+ ", new balance is 
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Deposit thread Withdraw thread 


Print 
"Depositing..." 


newBalance = 


Deposit thread reaches 
balance + amount 


the end of its time slice; 
local variable 
newBalance is 100 


Print 
"Withdrawing...' 


newBalance = 
balance - amount 


Print '', new 
balance is...’ 


balance 
is now —100 
balance = 
newBalance 


Print", new 
balance-is=— 


balance 


is now 100 
balance = 


newBalance 


Figure 1  Corrupting the Contents of the balance Field 


Suppose further that you make the same change in the withdraw method. If you run 
the resulting program, everything seems to be fine. 

However, that 1s a dangerous illusion. The problem hasn’t gone away; it has 
become much less frequent, and, therefore, more difficult to observe. It is still pos- 
sible for the deposit method to reach the end of its time slice after it has computed 
the right-hand-side value 


balance + amount 
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but before it performs the assignment 
balance = the right-hand-side value 


When the method regains control, it finally carries out the assignment, putting the 
wrong value into the balance field. 


ch20/unsynch/BankAccountThreadRunner.java 


Ll /** 
2 This program runs two threads that deposit and withdraw 
3 money from the same bank account. 
4 */ 
5 public class BankAccountThreadRunner 
6 { 
7 public static void main(String[] args) 
8 { 
9 BankAccount account = new BankAccount(); 
10 final double AMOUNT = 100; 
Ll final int REPETITIONS = 100; 
12 final int THREADS = 100; 
13 
14 for Cint i = 1; 71 <= THREADS; i++) 
15 { 
16 DepositRunnable d = new DepositRunnable( 
17 account, AMOUNT, REPETITIONS) ; 
18 WithdrawRunnable w = new WithdrawRunnable( 
19 account, AMOUNT, REPETITIONS) ; 
20 
21 Thread dt = new Thread(d); 
22 Thread wt = new Thread(w); 
23 
24 dt.starto: 
25 wt.startQ): 
26 } 
zi } 
28 } 


ch20/unsynch/DepositRunnable.java 


l < 

: A deposit runnable makes periodic deposits to a bank account. 

4 public class DepositRunnable implements Runnable 

ae! 

6 ia 

7 Constructs a deposit runnable. 

8 @param anAccount the account into which to deposit money 
9 @param anAmount the amount to deposit in each repetition 
10 @param aCount the number of repetitions 
11 | 
12 public DepositRunnable(BankAccount anAccount, double anAmount, 
13 int aCount) 
14 { 


15 account = anAccount; 


20.3 


36 
37 3} 
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amount = anAmount; 
count = aCount; 


} 
public void run() 
rt 
try 
{ 
for Cint i = 1; 1 <= count; i++) 
{ 
account.deposit(Camount) ; 
Thread.sleepCDELAY) ; 
y 
} 
catch (InterruptedException exception) {} 
} 


private static final int DELAY = 1; 
private BankAccount account; 
private double amount; 

private int count; 


ch20/unsynch/WithdrawRunnable.java 


3 
3 
4 
| 
6 
7 
8 


A withdraw runnable makes periodic withdrawals from a bank account. 


public class WithdrawRunnable implements Runnable 


[ee 
Constructs a withdraw runnable. 
@param anAccount the account from which to withdraw money 
@param anAmount the amount to deposit in each repetition 
@param aCount the number of repetitions 


public WithdrawRunnable(BankAccount anAccount, double anAmount, 
int aCount) 
{ 
account = anAccount; 
amount = anAmount; 
count = aCount; 


} 
public void run() 
{ 

try 

{ 


for Cint i = 1; 71 <= count; i++) 
{ 
account.withdraw(Camount) ; 
Thread.sleep (DELAY) ; 
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29 

30 catch (InterruptedException exception) {} 
31 } 

32 

33 private static final int DELAY = i; 

34 private BankAccount account; 

35 private double amount; 

36 private int count; 

37} 


ch20/unsynch/BankAccount.java 


A bank account has a balance that can be changed by 
deposits and withdrawals. 


2 

3 

4 */ 

2 public class BankAccount 
7 

8 


f 
[ee 
Constructs a bank account with a zero balance. 

9 4 
10 public BankAccount() 
11 { 
12 balance = 0: 
13 } 
14 
15 [ee 
16 Deposits money into the bank account. 
+ @param amount the amount to deposit 
4 public void deposit(double amount) 

{ 

21 System.out.print("Depositing " + amount); 
22 double newBalance = balance + amount; 
23 System.out.printiIn(’, new balance is " + newBalance): 
24 balance = newBalance; 
25 } 
26 
27 [ee 
28 Withdraws money from the bank account. 
@param amount the amount to withdraw 
ef public void withdraw(double amount) 

3 { 
33 System.out.print("Withdrawing " + amount): 
34 double newBalance = balance - amount; 
35 System.out.printIn(", new balance jis " 
36 balance = newBalance; 
37 } 
38 
39 [ee 
40 Gets the current balance of the bank account. 


41 @return the current balance 


+ newBalance); 
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43 public double getBalance() 
44 f 
45 return balance; 
46 } 
| 47 
| 48 private double balance; 
| 49 } 
Output 


Depositing 100.0, new balance is 100.0 
Withdrawing 100.0, new balance is 0.0 
Depositing 100.0, new balance is 100.0 
Withdrawing 100.0, new balance is 0.0 


Withdrawing 100.0, new balance is 400.0 
Depositing 100.0, new balance is 500.0 
Withdrawing 100.0, new balance is 400.0 
Withdrawing 100.0, new balance is 300.0 


SELF CHECK 


5. Give a scenario in which a race condition causes the bank balance to be —-100 
after one iteration of a deposit thread and a withdraw thread. 


| 6. Suppose two threads simultaneously insert objects into a linked list. Using the 
implementation in Chapter 15, explain how the list can be damaged in the 
process. 


To solve problems such as the one that you observed in the preceding section, use a 
lock object. The lock object is used to control the threads that want to manipulate a 
shared resource. 

The Java library defines a Lock interface and several classes that implement this 
interface. The ReentrantLock class is the most commonly used lock class, and the 
only one that we cover in this book. (Locks are a feature added in Java version 5.0. 
Earlier versions of Java have a lower-level facility for thread synchronization —see 
Advanced Topic 20.2) 

Typically, a lock object is added to a class whose methods access shared 
resources, like this: 


| public class BankAccount 
| { 
| public BankAccount() 
{ 


balanceChangeLock = new ReentrantLockQ) ; 
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} 


private Lock balanceChangeLock; 
} 
All code that manipulates the shared resource is surrounded by calls to lock and 
unlock the lock object: 


balanceChangeLock. lockQ); 

Code that manipulates the shared resource 

balanceChangeLock.unlock() ; 
However, this sequence of statements has a potential flaw. If the code between the 
calls to lock and unlock throws an exception, the call to unlock never happens. This 
is a serious problem. After an exception, the current thread continues to hold the 
lock, and no other thread can acquire it. To overcome this problem, place the call to 
unlock into a finally clause: 


balanceChangeLock. lock(); 
cry 


Code that manipulates the shared resource 


} 
finally 
{ 
balanceChangeLock.unlock(); 
} 


For example, here is the code for the deposit method: 


public void deposit(double amount) 


balanceChangeLock. lock(); 

try 

{ 
System.out.printC"Depositing " + amount); 
double newBalance = balance + amount; 
System.out.printIn(", new balance is " + newBalance); 
balance = newBalance; 

} 

Finally 

{ 
balanceChangeLock.unlock(); 

} 

} 


When a thread calls the lock method, it owns the lock until it calls the 
unlock method. If a thread calls lock while another thread owns the 
a hock OnieceHeREHG lock, it is temporarily deactivated. The thread scheduler periodically 
ether these can ac quire reactivates such a thread so that it can again try to acquire the lock. If 
fhe aa eee Rte the lock is still unavailable, the thread is again deactivated. Eventu- 
threscepelascas enesoc: ally, when the lock is available because the original thread unlocked 
it, the waiting thread can acquire the lock. 

One way to visualize this behavior is to imagine that the lock object is the lock of 

an old-fashioned telephone booth and the threads are people wanting to make tele- 

phone calls (see Figure 2). The telephone booth can accommodate only one person 


By calling the lock 
method, a thread acquires 
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Figure 2 
Visualizing Object Locks 


at one time. If the booth is empty, then the first person wanting to make a call goes 
inside and closes the door. If another person wants to make a call and finds the 
booth occupied, then the second person needs to wait until the first person leaves 
the booth. If multiple people want to gain access to the telephone booth, they all 
wait outside. They don’t necessarily form an orderly queue; a randomly chosen 
person may gain access when the telephone booth becomes available again. (Some 
computer programmers think of a rest-room stall instead of a telephone booth in 
order to visualize object locks. However, in the interest of good taste, we will not 
develop that analogy any further.) 

With the ReentrantLock class, a thread can call the lock method on a lock object 
that it already owns. This can happen if one method calls another, and both start by 
locking the same object. The thread gives up ownership if the unlock method has 
been called as often as the lock method. 

By surrounding the code in both the deposit and withdraw methods with lock 
and unlock calls, we ensure that our program will always run correctly. Only one 
thread at a time can execute either method on a given object. Whenever a thread 
acquires the lock, it is guaranteed to execute the method to completion before the 
other thread gets a chance to modify the balance of the same bank account object. 


SELF CHECK 


7. If you construct two BankAccount objects, how many lock objects are created? 


8. What happens if we omit the call unlock at the end of the deposit method? 
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A deadlock occurs if no. 
thread can proceed 
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te 


You can use lock objects to ensure that shared data are in a consistent 
state when several threads access them. However, locks can lead to 


because eachthreadis .-—«- another problem. It can happen that one thread acquires a lock and 
waiting for another todo then waits for another thread to do some essential work. If that other 
some work first. thread is currently waiting to acquire the same lock, then neither of 


the two threads can proceed. Such a situation is called a deadlock or 
deadly embrace. Let’s look at an example. 
Suppose we want to disallow negative bank balances in our program. Here’s a 
naive way of doing that. In the run method of the WithdrawRunnable class, we can 
check the balance before withdrawing money: 


if Caccount.getBalance() >= amount) 
account.withdraw(Camount) ; 


This works if there is only a single thread running that withdraws money. But sup- 
pose we have multiple threads that withdraw money. Then the time slice of the cur- 
rent thread may expire after the check account.getBalance() >= amount passes, but 
betore the withdraw method is called. If, in the interim, another thread withdraws 
more money, then the test was useless, and we still have a negative balance. 

Clearly, the test should be moved inside the withdraw method. That ensures that 
the test for sufficient funds and the actual withdrawal cannot be separated. Thus, 
the withdraw method could look like this: 


public void withdraw(double amount) 


{ 
balanceChangeLock. lockQ); 
try 
{ 
while (balance < amount) 
Wait for the balance to grow 
} 
finally 
: 
balanceChangeLock.unlock(); 
j 
; 


But how can we wait for the balance to grow? We can’t simply call sleep inside the 
withdraw method. If a thread sleeps after acquiring a lock, it blocks all other threads 
that want to use the same lock. In particular, no other thread can successfully exe- 
cute the deposit method. Other threads will call deposit, but they will simply be 
blocked until the withdraw method exits. But the withdraw method doesn’t exit until 
it has funds available. This is the deadlock situation that we mentioned earlier. 

To overcome this problem, we use a condition object. Condition objects allow a 
thread to temporarily release a lock, so that another thread can proceed, and to 
regain the lock at a later time. 
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In the telephone booth analogy, suppose that the coin reservoir of the telephone 
is completely filled, so that no further calls can be made until a service technician 
removes the coins. You don’t want the person in the booth to go to sleep with the 
door closed. Instead, think of the person leaving the booth temporarily. That gives 
another person (hopefully a service technician) a chance to enter the booth. 

Each condition object belongs to a specific lock object. You obtain a condition 
object with the newCondition method of the Lock interface. For example, 


public class BankAccount 


{ 
public BankAccount () 
1 
balanceChangeLock = new ReentrantLock() ; 
sufficientFundsCondition = balanceChangeLock.newCondition() ; 
} 
private Lock balanceChangeLock; 
private Condition sufficientFundsCondition; 
} 


It is customary to give the condition object a name that describes the condition that 
you want to test (such as “sufficient funds”). You need to implement an appropriate 
test. As long as the test is not fulfilled, call the await method on the condition 


object: 
public void withdraw(double amount) 
{ 
balanceChangeLock. lock() ; 
try 
i 
while (balance < amount) 
sufficientFundsCondition.await() ; 
} 
finally 
balanceChangeLock.unlock() ; 
I 
} 


When a thread calls await, it is not simply deactivated in the same 
way as a thread that reaches the end of its time slice. Instead, it is in a 
Ea cit blocked state, and it will not be activated by the thread scheduler 
sey tlowe snother thread until it is unblocked. To unblock, another thread must execute the 
to acquire the lock object, | SignalATl method on the same condition object. The signalA11 
method unblocks all threads waiting on the condition. They can then 
compete with all other threads that are waiting for the lock object. Eventually, one 

of them will gain access to the lock, and it will exit from the await method. 

In our situation, the deposit method calls signalA11: 


Calling await ona 
condition object makes 


public void deposit(double amount) 


{ 
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blocked until another 
thread calls signalA11 or 
signal on the condition 
object for which the 
thread is waiting. 
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balanceChangeLock. lock(); 


try 
{ 
sufficientFundsCondition.signalAl1(Q; 
} 
finally 
_ 
balanceChangeLock.unlock(); 
} 


The call to signalA11 notifies the waiting threads that sufficient funds 
may be available, and that it is worth testing the loop condition 
again. 

In the telephone booth analogy, the thread calling await corre- 
sponds to the person who enters the booth and finds that the phone 
doesn’t work. That person then leaves the booth and waits outside, 
depressed, doing absolutely nothing, even as other people enter and 
leave the booth. The person knows it is pointless to try again. At 
some point, a service technician enters the booth, empties the coin reservoir, and 
shouts a signal. Now all the waiting people stop being depressed and again compete 
for the telephone booth. 

There is also a signal method, which randomly picks just one thread that is wait- 
ing on the object and unblocks it. The signal method can be more efficient, but it is 
useful only if you know that every waiting thread can actually proceed. In general, 
you don’t know that, and signal can lead to deadlocks. For that reason, we recom- 
mend that you always call signalA11. 

The await method can throw an InterruptedException. The withdraw method 
propagates that exception, because it has no way of knowing what the thread that 
calls the withdraw method wants to do if it is interrupted. 

With the calls to await and signalA11 in the withdraw and deposit methods, we 
can launch any number of withdrawal and deposit threads without a deadlock. If 
you run the sample program, you will note that all transactions are carried out 
without ever reaching a negative balance. 


ch20/synch/BankAccountThreadRunner.java 


1 

2 This program runs four threads that deposit and withdraw 
3 money from the same bank account. 

4 a] 

5 public class BankAccountThreadRunner 

6 { 

7 public static void main(String[] args) 

8 { 

9 BankAccount account = new BankAccount(); 
10 final double AMOUNT = 100; 
11 final int REPETITIONS = 100; 
12 final int THREADS = 100; 
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14 for (int i = 1; i <= THREADS; i++) 

15 { 

16 DepositRunnable d = new DepositRunnable( 
17 account, AMOUNT, REPETITIONS) ; 

18 WithdrawRunnable w = new WithdrawRunnable( 
19 account, AMOUNT, REPETITIONS) ; 

20 

21 Thread dt = new Thread(d); 

22 Thread wt = new Thread(w); 

23 

24 dt.starco)® 

25 wt.startQO: 

26 } 

cae | } 

28 } 


ch20/synch/BankAccount.java 


1 import java.util.concurrent. locks.Condition; 
2 import java.util.concurrent. locks.Lock; 
3 import java.util.concurrent.locks.ReentrantLock; 
4 
5 wa 
6 A bank account has a balance that can be changed by 
7 deposits and withdrawals. 
8 + 
9 public class BankAccount 
10 { 
11 [e* 
12 Constructs a bank account with a zero balance. 
13 * / 
14 public BankAccount() 
15 { 
16 balance = 0; 
Ey f balanceChangeLock = new ReentrantLockQ) ; 
18 sufficientFundsCondition = balanceChangeLock.newCondition() ; 
19 } 
20 
21 [we 
ras Deposits money into the bank account. 
23 @param amount the amount to deposit 
24 * 
25 public void deposit(double amount) 
26 i 
27 balanceChangeLock. lockQ); 
28 try 
29 { 
30 System.out.print("Depositing " + amount); 
31 double newBalance = balance + amount; 
32 System.out.printIn(", new balance is " + newBalance) ; 
33 balance = newBalance; 
34 sufficientFundsCondition.signalAl1Q; 


867 


868 


CHAPTER 20 «# Multithreading 


36 finally 

37 

38 balanceChangeLock.unlock(); 

39 } 

40 5 

Al 

42 

43 Withdraws money from the bank account. 

6, LA @param amount the amount to withdraw 

45 a7 

AG public void withdraw(double amount) 

47 throws InterruptedException 

48 { 

49 balanceChangeLock. lock(); 

50 try 

51 { 

52 while (balance < amount) 

53 sufficientFundsCondition.await(); 
54 System.out.printC"Withdrawing " + amount); 
55 double newBalance = balance - amount; 
56 System.out.printIn(", new balance is " + newBalance): 
a7 balance = newBalance; 

58 } 

59 finally 

60 { 

61 balanceChangeLock.unlock(); 

62 : 

63 } 

64 

65 | 

66 Gets the current balance of the bank account. 
67 @return the current balance 

68 =] 

69 public double getBalance() 

70 { 

71 return balance; 

72 } 

73 

74 private double balance; 

75 private Lock balanceChangeLock; 

76 private Condition sufficientFundsCondition: 
77} 

Output 


Depositing 100.0, new balance is 100.0 
Withdrawing 100.0, new balance jis 0.0 
Depositing 100.0, new balance is 100.0 
Depositing 100.0, new balance is 200.0 


Withdrawing 100.0, new balance is 100.0 
Depositing 100.0, new balance is 200.0 
Withdrawing 100.0, new balance is 100.0 
Withdrawing 100.0, new balance jis 0.0 
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SELF CHECK 


9. What is the essential difference between calling sleep and await? 


10. Why is the sufficientFundsCondition object a field of the BankAccount class and 
not a local variable of the withdraw and deposit methods? 


COMMON ERROR 20.1 


Calling await Without Calling signalAl1 


It is intuitively clear when to call await. If a thread finds out that it can’t do its job, it has to 
wait. But once a thread has called await, it temporarily gives up all hope and doesn’t try 
again until some other thread calls signalA11 on the condition object for which the thread is 
waiting. In the telephone booth analogy, if the service technician who empties the coin reser- 
voir doesn’t notify the waiting people, they'll wait forever. 

A common error is to have threads call await without matching calls to signalAl1 by 
other threads. Whenever you call await, ask yourself which call to signa1A11 will signal your 
waiting thread. 


COMMON ERROR 20.2 
Calling signalAl1 Without Locking the Object 


The thread that calls signalA17 must own the lock that belongs to the condition object on 
which signalA11 is called. Otherwise, an I]11egalMonitorStateException is thrown. 

In the telephone booth analogy, the service technician must shout the signal while inside 
the telephone booth after emptying the coin reservoir. 

In practice, this should not be a problem. Remember that signalA11 is called by a thread 
that has just changed the state of some shared data in a way that may benefit waiting threads. 
That change should be protected by a lock in any case. As long as you use a lock to protect 
all access to shared data, and you are in the habit of calling signalA11 after every beneficial 
change, you won’t run into problems. But if you use signalA11 in a haphazard way, you may 
encounter the I1legalMonitorStateException. 
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ADVANCED ToPic 20.2 


Object Locks and Synchronized Methods 


The Lock and Condition classes were added in Java version 5.0. They overcome limitations of 
the thread synchronization mechanism in earlier Java versions. In this note, we discuss that 
classic mechanism. 

Every Java object has one built-in lock and one built-in condition variable. The lock 
works in the same way as a ReentrantLock object. However, to acquire the lock, you call a 
synchronized method. 

You simply tag all methods that contain thread-sensitive code (such as the deposit and 
withdraw methods of the BankAccount class) with the synchronized keyword. 


public class BankAccount 


{ 
public synchronized void deposit(double amount) 
{ 
System.out.printC"Depositing " + amount); 
double newBalance = balance + amount; 
System.out.println(", new balance is " + newBalance); 
balance = newBalance; 
. 
public synchronized void withdraw(double amount) 
1 
} 
t 


When a thread calls a synchronized method on a BankAccount object, it owns the lock of that 
object until it returns from the method and thereby unlocks the object. When an object is 
locked by one thread, no other thread can enter a synchronized method for that object. 
When another thread makes a call to a synchronized method for that object, the other thread 
is automatically deactivated, and it needs to wait until the first thread has unlocked the object 
again. 

In other words, the synchronized keyword automatically implements the lock/try/ 
finally/unlock idiom for the built-in lock. 

The object lock has a single condition variable that you manipulate with the wait, 
notifyAll, and notify methods of the Object class. If you call x.waitQ, the current thread is 
added to the set of threads that is waiting for the condition of the object x. Most commonly, 
you will call wait©, which makes the current thread wait on this. For example, 


public synchronized void withdraw(double amount) 
throws InterruptedException 


{ 
while (balance < amount) 
wait(); 
} 
The call notifyA11© unblocks all threads that are waiting for this: 
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public synchronized void deposit(double amount) 


{ 


notifyAl1Q; 
} 
This classic mechanism is undeniably simpler than using explicit locks and condition vari- 
ables. However, there are limitations. Each object lock has one condition variable, and you 
can’t test whether another thread holds the lock. If these limitations are not a problem, by all 
means, go ahead and use the synchronized keyword. If you need more control over threads, 
the Lock and Condition interfaces give you additional flexibility. 


ADVANCED TOPIC 20.3 


The Java Memory Model 


In a computer with multiple CPUs, you have to be particularly careful when multiple 
threads access shared data. Since modern processors are quite a bit faster than RAM memory, 
each CPU has its own memory cache that stores copies of frequently used memory locations. 
If a thread changes shared data, another thread may not see the change until both processor 
caches are synchronized. The same effect can happen even on a computer with a single 
CPU — occasionally, memory values are cached in CPU registers. 

The Java language specification contains a set of rules, called the memory model, that 
describes under which circumstances the virtual machine must ensure that changes to shared 
data are visible in other threads. One of the rules states the following: 


e Ifathread changes shared data and then releases a lock, and another thread acquires the 
same lock and reads the same data, then it is guaranteed to see the changed data. 


However, if the first thread does not release a lock, then the virtual machine is not required 
to write cached data back to memory. Similarly, if the second thread does not acquire the 
lock, the virtual machine is not required to refresh its cache from memory. 

Thus, you should always use locks or synchronized methods when you access data that is 
shared among multiple threads, even if you are not concerned about race conditions. 


Algorithm. Animation.......... 


eae set 
Sart ees 


One popular use for thread programming is animation. A program that displays an 
animation shows different objects moving or changing in some way as time 
progresses. This is often achieved by launching one or more threads that compute 
how parts of the animation change. 

You can use the Swing Timer class for simple animations without having to do 
any thread programming—see Exercise P20.12 for an example. However, more 
advanced animations are best implemented with threads. 
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In this section, you will see a particular kind of animation, namely the visualiza- 
tion of the steps of an algorithm. Algorithm animation is an excellent technique for 
gaining a better understanding of how an algorithm works. Many algorithms can be 
animated —type “Java algorithm animation” into your favorite web search engine, 
and you'll find lots of links to web pages with animations of various algorithms. 

All algorithm animations have a similar structure. The algorithm runs in a sepa- 
rate thread that periodically updates an image of the current state of the algorithm 
and then pauses so that the user can view the image. After a short amount of time, 
the algorithm thread wakes up again and runs to the next point of interest in the 
algorithm. It then updates the image and pauses again. This sequence is repeated 
until the algorithm has finished. 

Let’s take the selection sort algorithm of Chapter 14 as an example. That algo- 
rithm sorts an array of values. It first finds the smallest element, by inspecting all 
elements in the array, and bringing the smallest element to the leftmost position. It 
then finds the smallest element among the remaining elements and brings it into the 
second position. It keeps going in that way. As the algorithm progresses, the sorted 
part of the array grows. 

Flow can you visualize this algorithm? It is useful to show the part of the array 
that is already sorted in a different color. Also, we want to show how each step of 
the algorithm inspects another element in the unsorted part. That demonstrates why 
the selection sort algorithm is so slow—it first inspects all elements of the array, 
then all but one, and so on. If the array has n elements, the algorithm inspects 
n+(n—-1)+(n-2)+---=n(n-1)/2 = O(n’) elements. To demonstrate that, we 
mark the currently visited element in red. 

Thus, the algorithm state is described by three items: 


e The array of values 
¢ The size of the already sorted area 


¢ The currently marked element 


This state is accessed by two threads: the thread that sorts the array and the thread 
that repaints the frame. We use a lock to synchronize access to the shared state. 
Finally, we add a component instance field to the algorithm class and augment the 
constructor to set it. That instance field is needed for repainting the component and 
finding out the dimensions of the component when drawing the algorithm state. 


public class SelectionSorter 


{ 
public SelectionSorter(Cint[] anArray, JComponent aComponent) 
{ 
a = anArray; 
sortStateLock = new ReentrantLock(); 
component = aComponent; 
} 


private JComponent component; 
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Figure 3 
A Step in the Animation of 
the Selection Sort Algorithm 


At each point of interest, the algorithm needs to pause so that the user can admire 
the graphical output. Supply the pause method shown below, and call it at various 
places in the algorithm. The pause method repaints the component and sleeps for a 
small delay that is proportional to the number of steps involved. 


public void pause(int steps) 
throws InterruptedException 
{ 
component. repaintQ) ; 
Thread.sleep(steps * DELAY); 
} 


We add a draw method to the algorithm class that can draw the current state of the 
data structure, with the items of special interest highlighted. The draw method 1s 
specific to the particular algorithm. This draw method draws the array elements as a 
sequence of sticks in different colors. The already sorted portion is blue, the marked 
position is red, and the remainder is black (see Figure 3). 


public void draw(Graphics2D g2) 
{ 
sortStateLock. lockQ(; 
try 
% 
int deltaX = component.getWidth() / a. length; 
for Cint i = 0; 1 < a. length; i++) 
{ 
if (i == markedPosition) 
g2.setColorCColor.RED) ; 
else if (i <= alreadySorted) 
g2.setColor(Color.BLUE) ; 
else 
g2.setColor(Color.BLACK) ; 
g2.draw(new Line2D.Double(i * deltaX, 0, 
1 * deltax, alil])); 
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$ 
} 
finally 
{ 
sortStateLock.unlock(); 
} 


} 


You need to update the special positions as the algorithm progresses and pause the 
animation whenever something interesting happens. The pause should be propor- 
tional to the number of steps that are being executed. For a sorting algorithm, pause 
one unit for each visited array element. 

Here is the minimumPosition method from Chapter 14, before the animation code 
is inserted. 


public int minimumPosition(int from) 


| 
int minPos = from; 
for Cint i = from + 1; i < a.length; i++) 
if Cali] < a[minPos]) minPos = i; 
return minPos; 
} 


After each iteration of the for loop, update the marked position of the algorithm 
state; then pause the program. To measure the cost of each step fairly, pause for two 
units of time, because two array elements were inspected. 


public int minimumPosition(int from) 
throws InterruptedException 


{ 
Int minPos = from; 
for Cint 1 = from + 1: i < a. length; i++) 
{ 
sortStateLock. lock(); 
try 
{ 
1f Cali] < a[minPos]) minPos = i; 
markedPosition = 7; 
} 
finally 
sortStateLock.unlock(); 
} 
pause(2); 
} 
return minPos; 
} 


The sort method is augmented in the same way. You will find the code at the end of 
this section. This concludes the modification of the algorithm class. Let us now turn 
to the component class. 


The component’s paintComponent method calls the draw method of the algorithm 
object. 
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public class SelectionSortComponent extends JComponent 


{ 
public void paintComponent(Graphics g) 
af 
| if Csorter == null) return; 
Graphics2D g2 = (Graphics2D) g; 
| sorter.draw(g2) ; 
| t 
private SelectionSorter sorter; 
iy 


The startAnimation method constructs a SelectionSorter object, which supplies a 
new array and the this reference to the component that displays the sorted values. 
Then the method constructs a thread that calls the sorter’s sort method. 


public void startAnimation() 


{ 
intl] values = ArrayUtil.randomIntArray(30, 300); 
sorter = new SelectionSorter(values, this); 


class AnimationRunnable implements Runnable 


1 


public void run() 


{ 
try 


{ 


sorter.sort(); 


} 


catch (CInterruptedException exception) 
{ 
} 


} 


Runnable r = new AnimationRunnable(); 
Thread t = new Thread(r); 
Es Start) = ; 

} 


The class for the program that displays the animation is at the end of this section. 
Run the program and the animation starts. 

Exercise P20.7 asks you to animate the merge sort algorithm of Chapter 14. If 
you do that exercise, then start both programs and run them in parallel to see which 
algorithm is faster. Actually, you may find the result surprising. If you build fair 
delays into the merge sort animation to account for the copying from and to the 
temporary array, you will find that it doesn’t perform all that well for small arrays. 
But if you increase the array size, then the advantage of the merge sort algorithm 
becomes clear. 
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ch20/animation/SelectionSortViewer.java 


1 import java.awt.BorderLayout; 
import javax.swing.JButton; 
import javax.swing.JFrame; 


2 
3 
4 
5 public class SelectionSortViewer 
6 
7 
8 


if 
public static void main(StringL] args) 
1 
9 JFrame frame = new JFrame(); 
10 
11 final int FRAME_WIDTH = 300; 
12 final int FRAME_HEIGHT = 400; 
13 
14 frame.setSizeC(FRAME_WIDTH, FRAME_HEIGHT) ; 
15 frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
16 
17 final SelectionSortComponent component 
18 = new SelectionSortComponent() ; 
19 frame.add(component, BorderLayout.CENTER) ; 
- 20 
21 Frame.setVisible(true); 
ZZ component. startAnimation() ; 
23 } 
24 3} 


ch20/animation/SelectionSortComponent.java 


import Java.awt.Graphics; 
import java.awt.Graphics2D; 
import javax.swing.JComponent; 


ale ole 
aoa 


A component that displays the current state of the selection sort algorithm. 


1 
Zz 
3 
4 
5 
6 
7 
8 public class SelectionSortComponent extends JComponent 
9 
10 
11 
12 


{ 
| hs 
Constructs the component. 

oo 
13 public SelectionSortComponent () 
14 4. 
15 intl] values = ArrayUtil.randomIntArray(30, 300); 
16 sorter = new SelectionSorter(values, this); 
17 ; 
18 
19 public void paintComponent (Graphics g) 
20 1 
21 Graphics2D g2 = (Graphics2D)g; 
PM a sorter.draw(g2) ; 
23 ; 


20.6 s Case Study: Algorithm Animation GRAPHICS TRACK 877 


25 fon 

26 Starts a new animation thread. 

27 * / 

28 public void startAnimationQ 

29 { 

30 class AnimationRunnable implements Runnable 
31 4 

32 public void run() 

35 i 

34 try 

35 { 

36 sorter.sort(); 

37 } 

38 catch (InterruptedException exception) 
39 af 

40 ; 

41 } 

42 } 

43 

44 Runnable r = new AnimationRunnable(); 
45 Thread t = new Thread(r); 

46 £.starcO: 

47 , 

48 

49 private SelectionSorter sorter; 

50} 


ch20/animation/SelectionSorter.java 


1 import java.awt.Color; 

2 import java.awt.Graphics2D; 

3 import java.awt.geom.Line2D; 

4 import java.util.concurrent. locks.Lock; 

5 ~import java.util.concurrent.locks.ReentrantLock; 
6 import javax.swing.JComponent; 

7 

8 

9 


This class sorts an array, using the selection sort 


10 algorithm. 


| ey 

12 public class SelectionSorter 

13 { 

14 ye 

15 Constructs a selection sorter. 

16 @param anArray the array to sort 

17 @param aComponent the component to be repainted when the animation 
18 pauses 

19 Py. 

20 public SelectionSorterGnt[] anArray, JComponent aComponent) 
21 { 

22 a = anArray; 

23 sortStateLock = new ReentrantLockQ() ; 

24 component = aComponent; 

25 } 
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26 

Zi = 

28 Sorts the array managed by this selection sorter. 
29 * 

30 public void sort() 

31 throws InterruptedException 

32 { 

33 for Cint i = 0; i < a.length - 1; 744) 
34 4 

35 int minPos = minimumPosition(i); 

36 sortStateLock. lock(); 

37 try 

38 { 

39 Swap(minPos, i); 

40 // For animation 

41 alreadySorted = 7; 

42 } 

43 finally 

44 { 

45 sortStateLock.unlock(); 

46 } 

47 pause(2); 

48 } 

49 } 

50 

51 hi 

ny Finds the smallest element in a tail range of the array. 
53 @param from the first position in a to compare 
54 @return the position of the smallest element in the 
55 rangealfrom] . . . afa.length - 1] 

56 oy 

sf private int minimumPosition(int from) 

58 throws InterruptedException 

59 { 

60 int minPos = from; 

61 for Cint i = from + 1; i < a.length; i++) 
62 { 

63 sortStateLock.lockQ; 

64 try 

65 { 

66 if Cali] < a[minPos]) minPos = i; 
67 // For animation 

68 markedPosition = 7; 

69 } 

70 finally 

71 { 

72 sortStateLock.unlock(); 

73 } 

74 pause(2); 

75 } 

76 return minPos; 

77 } 
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[x 
Swaps two entries of the array. 
@param i the first position to swap 
@param j the second position to swap 


private void swap(int i, int j) 


{ 
int temp = ali]; 
ali] = aljl; 
alj] = temp; 

} 

ye 


Draws the current state of the sorting algorithm. 
@param g2 the graphics context 


public void draw(Graphics2D g2) 


{ 
sortStateLock. lockQ; 
try 
{ 
int deltaX = component.getWidthQ) / a. length; 
for Gnt 1 = 0; 1 < a. length; i++) 
if C1 == markedPosition) 
g2.setColor(Color.RED) ; 
else if (i <= alreadySorted) 
g2.setColor(Color.BLUE) ; 
else 
g2.setColor(Color.BLACK) ; 
g2.draw(new Line2D.Double(i * deltaX, 0, 
i * deltaX, a[li])); 
} 
} 
finally 
{ 
sortStateLock.unlockQ( ; 
} 
I; 
Viens 


Pauses the animation. 
@param steps the number of steps to pause 


public void pause(int steps) 
throws InterruptedException 
{ 
component.repaintdQ ; 
Thread.sleep(steps * DELAY); 
} 


private int[] a; 
private Lock sortStateLock; 
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132 

133 // The component is repainted when the animation is paused 
134 private JComponent component; 

135 

136 // These fields are needed for drawing 

137 private int markedPosition = -1; 

138 private int alreadySorted = -1; 

139 

140 private static final int DELAY = 100: 

141 3} 

SELF CHECK 


11. Why is the draw method added to the SelectionSorter class and not the 
SelectionSortComponent class? 


12. Would the animation still work if the startAnimation method simply called 
sorter.sort() instead of spawning a thread that calls that method? 


RANDOM FAcT 20.1 


Embedded Systems 


An embedded system is a computer system that controls a device. The device contains a pro- 
cessor and other hardware and is controlled by a computer program. Unlike a personal com- 
puter, which has been designed to be flexible and run many different computer programs, the 
hardware and software of an embedded system are tailored to a specific device. Computer- 
controlled devices are becoming increasingly common, ranging from washing machines to 
medical equipment, automobile engines, and spacecraft. 

Several challenges are specific to programming embedded systems. Most importantly, a 
much higher standard of quality control applies. Vendors are often unconcerned about bugs 
in personal computer software, because they can always make you install a patch or upgrade 
to the next version. But in an embedded system, that is not an option. Few consumers would 
feel comfortable upgrading the software in their washing machines or automobile engines. If 
you ever handed in a programming assignment that you believed to be correct, only to have 
the instructor or grader find bugs in it, then you know how hard it is to write software that 
can reliably do its task for many years without a chance of changing it. 

Quality standards are especially important in devices whose failure would destroy prop- 
erty or human life—see Random Facts 7.2 and 11.1. 

Many personal computer purchasers buy computers that are fast and have a lot of storage, 
because the investment is paid back over time when many programs are run on the same 
equipment. But the hardware for an embedded device is not shared—it is dedicated to one 
device. A separate processor, memory, and so on, are built for every copy of the device (see 
Figure 4). If it is possible to shave a few pennies off the manufacturing cost of every unit, the 
savings can add up quickly for devices that are produced in large volumes. Thus, the embed- 
ded-system programmer has a much larger economic incentive to conserve resources than 
the programmer of desktop software. Unfortunately, trying to conserve resources usually 
makes it harder to write programs that work correctly. 
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Figure 4 The Controller of an Embedded System 
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Generally, embedded systems are written in lower-level programming languages to avoid 
the overhead of a complex run-time system. The Java run-time system, with its safety mech- 
anisms, garbage collector, support for multithreading, and so on, would be too costly to add 
to every washing machine. However, some devices are now being built with a scaled-down 
version of Java: the Java 2 Micro Edition. Examples are smart cell phones and onboard 
computers for automobiles. The Java 2 Micro Edition is a good candidate for devices that are 
connected to a network and that need to be able to run new applications safely. For example, 
you can download a program into a Java-enabled cell phone and be assured that it cannot 
corrupt other parts of the cell phone software. 


CHAPTER SUMMARY 


1. A thread is a program unit that is executed independently of other parts of the 
program. 


2. The start method of the Thread class starts a new thread that executes the run 
method of the associated Runnable object. 


3. The sleep method puts the current thread to sleep for a given number of 
milliseconds. 
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10. 


11. 


12. 


. When a thread is interrupted, the most common response is to terminate the run 


method. 


. The thread scheduler runs each thread for a short amount of time, called a time 


slice. 


. A thread terminates when its run method terminates. 


. The run method can check whether its thread has been interrupted by calling 


the interrupted method. 


A race condition occurs if the effect of multiple threads on shared data depends 
on the order in which the threads are scheduled. 


By calling the lock method, a thread acquires a Lock object. Then no other 
thread can acquire the lock until the first thread releases the lock. 


A deadlock occurs if no thread can proceed because each thread is waiting for 
another to do some work first. 


Calling await on a condition object makes the current thread wait and allows 
another thread to acquire the lock object. 


A waiting thread is blocked until another thread calls signalA11 or signal on 
the condition object for which the thread 1s waiting. 


CLASSES, OBJECTS, AND METHODS 
INTRODUCED IN THIS CHAPTER 


java. lang. InterruptedException java.util.Date 


java.lang.Object java.util.concurrent. locks.Condition 
notify await 
notifyAll Signal 
wait signalAl | 
java. lang.Runnable java.uti].concurrent. locks.Lock 
run lock 
java. lang. Thread newCondition 
interrupted unlock 
sleep java.util.concurrent. locks.ReentrantLock 
Start 


REVIEW EXERCISES 


* Exercise R20.1. Run a program with the following instructions: 


GreetingRunnable rl = new GreetingRunnable("Hello, World!"); 
GreetingRunnable r2 = new GreetingRunnable("Goodbye, World!"); 


rl.rund); 
r2.runC): 
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Note that the threads don’t run in parallel. Explain. 


Exercise R20.2. In the program of Section 20.1, is it possible that both threads are 
sleeping at the same time? Is it possible that neither of the two threads is sleeping at 
a particular time? Explain. 


Exercise R20.3. In Java, a graphical user interface program has more than one thread. 
Explain how you can prove that. 


Exercise R20.4. Why is the stop method for stopping a thread deprecated? How do 
you terminate a thread? 


Exercise R20.5. Give an example of why you would want to terminate a thread. 


Exercise R20.6. Suppose you surround each call to the sleep method with a try/ 
catch block to catch an InterruptedException and ignore it. What problem do you 
create? 


Exercise R20.7. What is a race condition? How can you avoid it? 
Exercise R20.8. What is a deadlock? How can you avoid it? 


Exercise R20.9. What is the difference between a thread that sleeps by calling sleep 
and a thread that waits by calling await? 


Exercise R20.10. What happens when a thread calls await and no other thread calls 
signalAll or signal? 


Exercise R20.11. In the algorithm animation program of Section 20.6, we do not use 
any conditions. Why not? 


Additional review exercises are available in WileyPLUS. 


PROGRAMMING EXERCISES 


Exercise P20.1. Implement a Queue class whose add and remove methods are synchro- 
nized. Supply one thread, called the producer, which keeps inserting strings into the 
queue as long as there are fewer than 10 elements in it. When the queue gets too full, 
the thread waits. As sample strings, simply use time stamps new Date().toString(). 
Supply a second thread, called the consumer, that keeps removing and printing 
strings from the queue as long as the queue is not empty. When the queue is empty, 
the thread waits. Both the consumer and producer threads should run for 100 
iterations. 


Exercise P20.2. Enhance Exercise P20.1 by supplying a variable number of producer 
and consumer threads. Prompt the program user for the numbers. 


Exercise P20.3. Reimplement Exercise P20.2 by using the ArrayBlockingQueue class 
from the standard library. 
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Exercise P20.4. Write a program WordCount that counts the words in one or more 
files. Start a new thread for each file. For example, if you call 


java WordCount report.txt address.txt Homework. java 
then the program might print 


address.txt: 1052 
Homework.java: 445 
report.txt: 2099 


Exercise P20.5. Write a program Find that searches all files specified on the command 
line and prints out all lines containing a keyword. Start a new thread for each file. 
For example, if you call 


java Find Buff report.txt address.txt Homework. java 
then the program might print 


report.txt: Buffet style lunch will be available at the 
address.txt: Buffet, Warren|11801 Trenton Court|Dallas|TX 
Homework.java: BufferedReader in; 

address.txt: Walters, Winnie|59 Timothy Circle|Buffalo|MI 


Exercise P20.6. Add a condition to the deposit method of the BankAccount class, 
restricting deposits to $100,000 (the insurance limit of the U.S. government). The 
method should block until sufficient money has been withdrawn by another thread. 
Test your program with a large number of deposit threads. 


Exercise P20.7. Implement the merge sort algorithm of Chapter 14 by spawning a 
new thread for each smaller MergeSorter. Hint: Use the join method of the Thread 
class to wait for the spawned threads to finish. Look up the method’s behavior in 
the API documentation. 


Exercise P20.8. Modify the car viewer of Chapter 3 so that the cars are moving. Use a 
separate thread for each car. 


Exercise P20.9. Modify Exercise P20.8 so that the cars change direction when they 
hit an edge of the window. 


Exercise P20.10. Enhance the SelectionSorter of Section 20.6 so that the current 
minimum is painted in yellow. 


Exercise P20.11. Enhance the SelectionSortViewer of Section 20.6 so that the sorting 
only starts when the user clicks a “Start” button. 


Exercise P20.12. Instead of using a thread and a pause method, use the Timer class of 
Chapter 9 to animate an algorithm. Whenever the timer sends out an action event, 
run the algorithm to the next step and display the state. That requires a more exten- 
sive recoding of the algorithm. You need to implement a runToNextStep method that 
is capable of running the algorithm one step at a time. Add sufficient instance fields 
to the algorithm to remember where the last step left off. For example, in the case of 
the selection sort algorithm, if you know the values of alreadySorted and 
markedPosition, you can determine the next step. 
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Exercise P20.13. Implement an animation of the merge sort algorithm of Chapter 14. 
Reimplement the algorithm so that the recursive calls sort the elements inside a sub- 
range of the the original array, rather than in their own arrays: 


public void mergeSortCint from, int to) 
: 
if (from == to) return; 
int mid = (from + to) / 2: 
mergeSort(from, mid); 
mergeSort(mid + 1, to); 
merge(from, mid, to); 
} 
The merge method merges the sorted ranges a[from] . . . a[mid] and a[mid + 1] 
. a[{to]. Merge the ranges into a temporary array, then copy back the tempo- 
rary array into the combined range. 


Pause in the merge method whenever you inspect an array element. Color the range 
a[from] . . . a[to] in blue and the currently inspected element in red. 


Exercise P20.14. Enhance Exercise P20.13 so that it shows two frames, one for a 
merge sorter and one for a selection sorter. They should both sort arrays with the 
same values. 


Additional programming exercises are available in WileyPLUS. 


PROGRAMMING PROJECTS 


Project 20.1. Implement a program that animates multiple sorting algorithms run- 
ning in parallel. For each algorithm, provide buttons to pause and resume the ani- 
mation, and to execute a single step. Provide sliders to control the animation speed. 


Project 20.2. Implement a program that animates multiple robots moving through a 
maze. Each robot should be animated by its own thread, moving to an adjacent 
unoccupied maze position and then sleeping. Use locking to ensure that no two 
robots occupy the same cell of the maze. 
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ANSWERS TO SELF-CHECK QUESTIONS 


12. 


. The messages are printed about one millisecond apart. 


. The first call to run would print ten “Hello” messages, and then the second call 


to run would print ten “Goodbye” messages. 


. If the user hits the “Back” button, the current web page is no longer displayed, 


and it makes no sense to expend network resources for fetching additional 
image data. 


. The run method prints the values 1, 3, and 4. The call to interrupt merely 


sets the interruption flag, but the sleep method immediately throws an 
InterruptedException. 


. There are many possible scenarios. Here is one: 


° The first thread loses control after the first print statement. 


¢ The second thread loses control just before the assignment 
balance = newBalance. 


° The first thread completes the deposit method. 
° The second thread completes the withdraw method. 


. One thread calls addFirst and is preempted just before executing the assign- 


ment first = newLink. Then the next thread calls addFirst, using the old value 
of first. Then the first thread completes the process, setting first to its new 
link. As a result, the links are not in sequence. 


. Two, one for each bank account object. Each lock protects a separate balance 


field. 


. When a thread calls deposit, it continues to own the lock, and any other thread 


trying to deposit or withdraw money in the same bank account is blocked 
forever. 


. A sleeping thread is reactivated when the sleep delay has passed. A waiting 


thread is only reactivated if another thread has called signalA11 or signal. 


. The calls to await and signal/signalAl1 must be made to the same object. 
11. 


The draw method uses the array values and the values that keep track of the 
algorithm’s progress. These values are available only in the SelectionSorter 
class. 


Yes, provided you only show a single frame. If you modity the 
SelectionSortViewer program to show two frames, you want the sorters 
to run in parallel. 


CHAPTER GOALS 


Chapter 4 


Internet 
Networking, 


To understand the concept of sockets 
To learn how to send and receive data through sockets 
To implement network clients and servers 


To communicate with web servers and server-side applications 
through the Hypertext Transfer Protocol (HTTP) 


You probably have quite a bit of experience with the Internet: the global network 
that links together millions of computers. In particular, you use the Internet 
whenever you browse the World Wide Web. Note that the Internet is not the same 
as the “Web”. The World Wide Web is only one of many services offered over the 
Internet. E-mail, another popular service, also uses the Internet, but its 
implementation differs from that of the Web. In this chapter, you will see what goes 
on “under the hood” when you send an e-mail message or when you retrieve a web 
page from a remote server. You will also learn how to write your own programs 
that fetch data from sites across the Internet and how to write server programs that 


can serve information to other programs. 
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21.1 The Internet Protocol 


The Internet isa 
worldwide collection of 


Computers can be connected with each other through a variety of 
physical media. In a computer lab, for example, computers are con- 


networks, routing nected by network cabling. Electrical impulses representing informa- 
equipment, and _ tion flow across the cables. If you use a DSL modem to connect your 
computers using a own computer to the Internet, the signals travel across a regular tele- 
common set of protocols phone wire, encoded as tones. On a wireless network, signals are sent 
to define how each party by transmitting a modulated radio frequency. The physical charac- 
ve interact with each teristics of these transmissions differ widely, but they ultimately con- 
other. 


sist of sending and receiving streams of zeroes and ones along the 
network connection. 

These zeroes and ones represent two kinds of information: application data, the 
data that one computer actually wants to send to another, and network protocol 
data, the data that describe how to reach the intended recipient and how to check 
for errors and data loss in the transmission. The protocol data follow certain rules 
set forth by a particular network protocol. Various network protocols are in com- 
mon use, such as Microsoft Networking, Novell NetWare, or AppleTalk; these are 
protocols for local area networks. The Internet Protocol (IP), on the other hand, 
was developed to enable different local area networks to communicate with each 
other and has become the basis for connecting computers around the world 
together over the Internet. We will discuss IP in this chapter. 

Suppose that a computer A wants to send data to a computer B, both on the 
Internet. The computers aren’t connected directly with a cable, as they could be if 
both were on the same local area network. Instead, A may be someone’s home com- 
puter and connected to an Internet service provider (ISP), which is in turn con- 
nected to an Internet access point; B might be a computer on a local area network 
belonging to a large firm that has an Internet access point of its own, which may be 
half a world away from A. The Internet itself, finally, is a complex collection of 
pathways on which a message can travel from one Internet access point to, eventu- 
ally, any other Internet access point (see Figure 1). Those connections carry mil- 
lions of messages, not just the data that A is sending to B. 
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Computer A Computer B 


Internet 
Access Points 


Internet Service Provider Internet 
Figure 1 Two Computers Communicating Across the Internet 


For the data to arrive at its destination, it must be marked with a destination 
address. In IP, addresses are denoted by sequences of four numbers, each one byte 
(that is, between 0 and 255); for example, 130.65.86.66. (Because there aren’t enough 
four-byte addresses for all devices that would like to connect to the Internet, these 
addresses will be extended to sixteen bytes in the near future.) In order to send data, 
A needs to know the Internet address of B and include it in the protocol portion 
when sending the data across the Internet. The routing software that is distributed 
across the Internet can then deliver the data to B. 

Of course, addresses such as 130.65.86.66 are not easy to remember. You would 
not be happy if you had to use number sequences every time you sent e-mail or 
requested information from a web server. On the Internet, computers can have so- 
called domain names that are easier to remember, such as cs.sjsu.edu or 
java.sun.com. A special service called the Domain Naming Service (DNS) translates 
between domain names and Internet addresses. Thus, if computer A wants to have 
information from java.sun.com, it first asks the DNS to translate this domain name 
into a numeric Internet address; then it includes the numeric address with the 
request. 

One interesting aspect of IP is that it breaks large chunks of data up into more 
manageable packets. Each packet is delivered separately, and different packets that 
are part of the same transmission can take different routes through the Internet. 
Packets are numbered, and the recipient reassembles them in the correct order. 

The Internet Protocol has just one function—to attempt to deliver 
data from one computer to another across the Internet. If some data 
get lost or garbled in the process, IP has safeguards built in to make 
sure that the recipient is aware of that unfortunate fact and doesn’t 
comimnin auc orstocel: rely on incomplete data. However, IP has no provisions for retrying 
tac uecd to ee tablich an incomplete transmission. That is the job of a higher-level proto- 
reliable transmission of col, the Transmission Control Protocol (TCP). This protocol attempts 
data between two reliable delivery of data, with retries if there are failures, and it notifies 
computers on the Internet. the sender whether or not the attempt succeeded. Most, but not all, 


TCP/IP is the abbreviation 
for Transmission Control 
Protocol over Internet 
Protocol, the pair of 
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Internet programs use TCP for reliable delivery. (Exceptions are “streaming media” 
services, which bypass the slower TCP for the highest possible throughput and tol- 
erate occasional information loss. However, the most popular Internet services — 
the World Wide Web and e-mail—use TCP.) TCP is independent of the Internet 
Protocol; it could in principle be used with another lower-level network protocol. 
However, in practice, TCP over IP (often called TCP/IP) is the most commonly 
used combination. We will focus on TCP/IP networking in this chapter. 
oe : A computer that is connected to the Internet may have programs 
- for many different purposes. For example, a computer may run botha 
web server program and a mail server program. When data are sent to 
that computer, they need to be marked so that they can be forwarded 
to the appropriate program. TCP uses port numbers tor this purpose. 
A port number is an integer between 0 and 65,535. The sending computer must 
know the port number of the receiving program and include it with the transmitted 
data. Some applications use “well-known” port numbers. For example, by conven- 
tion, web servers use port 80, whereas mail servers running the Post Office Protocol 
(POP) use port 110. TCP packets, therefore, must contain 


e The Internet address of the recipient 
e The port number of the recipient 
e The Internet address of the sender 


e The port number of the sender 


You can think of a TCP connection as a “pipe” between two computers that links 
the two ports together. Data flow in either direction through the pipe. In practical 
programming situations, you simply establish a connection and send data across it 
without worrying about the details of the TCP/IP mechanism. You will see how to 
establish such a connection 1n Section 21.3. 


SELF CHECK 


4. What is the difference between an IP address and a domain name? 


2. Why do some streaming media services not use TCP? 


e e 
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In the preceding section you saw how the TCP/IP mechanism can 
establish an Internet connection between two ports on two comput- 


‘communication fs so that the two computers can exchange data. Each Internet appli- 


en web browsers and cation has a different application protocol, which describes how the 


data for that particular application are transmitted. 


21.2 8 Application Level Protocols 891 


Consider, for example, HTTP: the Hypertext Transfer Protocol, 
which is used for the World Wide Web. Suppose you type a web 
-, address, called a Uniform Resource Locator (URL, often pronounced 
oe a web Ae al image) like “Earl”), such as http://java.sun.com/index.html, into the 
cont the World Wide Web. address window of your browser and ask the browser to load the 

page. 
The browser now takes the following steps: 


: a URL, ee Resource 


1. It examines the part of the URL between the double slash and the first single 
slash (“java.sun.com”), which identifies the computer to which you want to 
connect. Because this part of the URL contains letters, it must be a domain 
name rather than an Internet address, so the browser sends a request to a DNS 
server to obtain the Internet address of the computer with domain name 
jJava.sun.com. 


2. From the http: prefix of the URL, the browser deduces that the protocol you 
want to use is HTTP, which by default uses port 80. 


3. It establishes a TCP/IP connection to port 80 at the Internet address it 
obtained in step 1. 


4. It deduces from the /index.htm1 suffix that you want to see the file / 
index.html, so it sends a request, formatted as an HTTP command, through 
the connection that was established in step 3. The request looks like this: 


GET /index. htm] HTTP/1.0 
blank line 


5. The web server running on the computer whose Internet address 1s the one the 
browser obtained in step 1 receives the request and decodes it. It then fetches 
the file /index.htm1 and sends it back to the browser on your computer. 


6. The browser displays the contents of the file. Because it happens to be an 
HTML file, the browser translates the HTML tags into fonts, bullets, separa- 
tor lines, and so on. If the HTML file contains images, then the browser makes 
more GET requests, one for each image, through the same connection, to fetch 
the image data. (Appendix H contains a summary of the most frequently used 


HTML tags.) 


You can try the following experiment to see this process in action. The “Telnet” 
program enables a user to type characters for sending to a remote computer and 
view characters that the remote computer sends back. On Windows, the Telnet pro- 
gram is usually already installed, but you probably won’t see it on your desktop; 
try clicking on the Start button, selecting “Run...”, and typing telnet at the 
“Open” window. UNIX, Linux, and Mac OS X systems normally have Telnet 
preinstalled. For this experiment, you want to start Telnet with a host of 
java.sun.com and port 80. The details depend on your Telnet program. If you start 
the program from the command line, simply type 


telnet java.sun.com 80 


(With some versions of Telnet, you need to enter the host and port into a dialog box 
instead of supplying the values on the command line.) 
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File 


View Terminal Go Help 


~$ telnet java.sun.com 80 
Trying 209.249.116.141... 
Connected to java.sun.com. 
Escape character is '“]'. 
GET / HTTP/1.0 


HITP/1.1 200 OK 

Server: Netscape-Enterprise/6.0 

Date: Thu, 22 Jul 2004 18:27:16 GMT | 
Content-type: text/html; charset=IS0-8859-1 
Set-cookie: JSESSIONID=java .sun . com-17d5e%253A41000701%253Ae493f41adc6fle:path=/ 


;expires=Thu, 22-Jul-2004 18:57:14 GMT 
Connection: close 


<!DOCTYPE HTML PUBLIC "-//W3C//DID HTML 4.01 Transitional//EN"> 


<title>Java Technology</title> 

<meta name="keywords" content="Java, platform" /> 
<meta name="description"” content="Java technology is a portfolio of products tha 
t are based on the power of networks and the idea that the same software should 
run on many different kinds of systems and devices." /> 

<meta http-equiv="Content-Type" content="text/html; charset=IS0-8859-1"/> 

<meta name="date" content="2003-11-23" /> 

— eo 


Figure 2 Using Telnet to Connect to a Web Server 


Once the program starts, type very carefully, without making any typing errors 
and without hitting the backspace key, 


GET / HTTP/1.0 


Then hit the Enter key twice. 
The first / denotes the root page of the web server. Note that there are spaces 
before and after the first /, but there are no spaces in HTTP/1.0. 


The Telnet program is a 

_ useful tool to establish 
test connections with 
servers. 


You may not see what you type, because the Telnet program sends 
your keystrokes directly to the server. (Some versions of Telnet have 
a “local echo” option that show you what you typed. If yours does, 
it is a good idea to turn it on for this experiment.) 

The server now sends a response to the request—see Figure 2. The 
response, of course, consists of the root web page that you requested. 


The Telnet program is not a browser and does not understand HTML tags, so it 
simply displays the HTML file—text, tags, and all. 

The GET command is one of the commands of HTTP. Table 1 shows the other 
commands of the protocol. As you can see, the protocol is pretty simple. 

By the way, be sure not to confuse HTML with HTTP. HTML is a document 
format (with commands such as <h1> or <u1>) that describes the structure of a docu- 
ment, including headings, bulleted lists, images, hyperlinks, and so on. HTTP is a 
protocol (with commands such as GET and POST) that describes the command set for 
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Table 1 HTTP Commands 
Command Meaning 
GET Return the requested item 
HEAD Request only the header information of an item 
OPTIONS Request communications options of an item 
POST Supply input to a server-side command and return the result 
PUT Store an item on the server 
DELETE Delete an item on the server 
TRACE Trace server communication 
‘The HTTP GET command web server requests. Web browsers know how to display HTML 
requests information from _ documents and how to issue HTTP commands. Web servers know 
Pe ee heey 2 «nothing about HTML. They merely understand HTTP and know 
‘server returnsthe how to fetch the requested items. Those items may be HTML docu- 
“requested item, which — ments, GIF or JPEG images, or any other data that a web browser 
may be a web page, an can display. 
_image, or other data. HTTP is just one of many application protocols in use on the 


Internet. Another commonly used protocol is the Post Office Proto- 

col (POP), which is used to download received messages from e-mail 
servers. To send messages, you use yet another protocol called the Simple Mail 
Transfer Protocol (SMTP). We don’t want to go into the details of these protocols, 
but Figure 3 gives you a flavor of the commands used by the Post Office Protocol. 


+OK San Quentin State POP server 
USER harryh 


+OK Password required for harryh 
PASS secret 


+OK harryh has 2 messages (320 octets) 
STAT 


+OK 2 320 

RETR 1 

+OK 120 octets 

the message is included here 
DEEE=1 


+OK message 1 deleted 
QUIT 


+OK POP server signing off 


Figure 3 Black = mail client requests 
A Sample POP Session Color = mail server responses 
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Both HTTP and POP use plain text, which makes it particularly easy to test and 
debug client and server programs (see How To 21.1). 


SELF CHECK 


3. Why don’t you need to know about HTTP when you use a web browser? 


4. Why is it important that you don’t make typing errors when you type HTTP 
commands in Telnet? 


e 
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In this section you will see how to write a Java program that establishes a TCP con- 
nection to a server, sends a request to the server, and prints the response. 
In the terminology of TCP/IP, there is a socket on each side of the 
connection (see Figure 4). In Java, a client establishes a socket with a 
ee call 


“other end point ofthe io example, to connect to the HTTP port of the server 
connection, use the input _ 
attached to the socket. 


Socket s = new Socket(hosiname, portnumber) ; 


java.sun.com, you use 


final int HTTP_PORT = 80; 
Socket s = new Socket("java.sun.com", HTTP_PORT); 


The socket constructor throws an UnknownHostException if it can’t find the host. 
Once you have a socket, you obtain its input and output streams: 


InputStream instream = s.getInputStream() ; 
OutputStream outstream = s.getOutputStream() ; 


When you send data to outstream, the socket automatically forwards it to the server. 
The socket catches the server’s response, and you can read the response through 
instream (see Figure 4). 


Client output stream Server input stream 


Client 455 Server. 
Socket | Socket 
Client input stream Server output stream 


Figure 4 Client and Server Sockets 


_ When transmission over a © 


socket is 
remembe 
socket. 
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complete, — 
r to close the 


For text protocols, turn 
the socket streams into 


scanners 


Flush the 


and writers. 


When you are done communicating with the server, you should 
close the socket: 


s.close(); 


In Chapter 15, you saw that the InputStream and OutputStream classes 
are used for reading and writing bytes. H you want to communicate 
with the server by sending and receiving text, you should turn the 
streams into scanners and writers, as follows: 


Scanner in = new Scanner(Cinstream) ; 
PrintwWriter out = new PrintWriter(outstream) ; 


A print writer buffers the characters that you send to it. That is, characters are not 
immediately sent to their destination. Instead, they are placed into an array. When 
the array is full, then the print writer sends all characters in the array to its destina- 
tion. The advantage of buffering is increased performance—it takes some amount of 
time to contact the destination and send it data, and it is expensive to pay for that 
contact time for every character. However, when communicating with a server that 
responds to requests, you want to make sure that the server gets a complete request 
at a time. Therefore, you need to flush the buffer manually whenever you send a 


command: 


out.print (commana) ; 
out.flush() ; 


writer attached 


to a socket at the end of 


“every command. Then the 


command is sent to the 
_ server, even if the writer’s 


_ buffer isn 


filled. 


‘ completely 


The flush method empties the buffer and forwards all waiting char- 
acters to the destination. 

The WebGet program at the end of this section lets you retrieve any 
item from a web server. You need to specify the host and the item 
from the command line. For example, 


java WebGet java.sun.com / 


The / item denotes the root page of the web server that listens to port 
80 of the host java.sun.com. Note that there is a space before the /. 


The program simply establishes a connection to the host, sends a GET command 
to the host, and then receives input from the server until the server closes its 


connection. 


ch21/webget/WebGetjava 


1 import 
2 import 
3 import 
4 import 
5 import 
6 import 
7 


java.10.InputStream; 
java.io.IOException; 
java.io.OutputStream; 
java.io.PrintWriter; 
java.net.Socket; 
java.util.Scanner; 
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8 [** 

9 This program demonstrates how to use a socket to communicate 
10 with a web server. Supply the name of the host and the 
11 resource on the command-line, for example, 

12 java WebGet java.sun.com index.html. 

13 c 

14 public class WebGet 

15 

16 public static void main(String[] args) throws IOException 
pe 4 

18 // Get command-line arguments 

19 

20 String host; 

2l String resource; 

22 

23 if Cargs.length == ?) 

24 if 

25 host = args[0]; 

26 resource = args[i]; 

27 } 

28 else 

29 1. 

30 System.out.printIn("Getting / from java.sun.com"); 
31 host = "java.sun.com"; 

32 resource = "/"; 

33 Mi 

34 

35 // Qpen socket 

36 

37 final int HTTP_PORT = 80; 

38 Socket Ss = new Socket(host, HTITP_PORT); 

39 

40 // Get streams 

41 

4? InputStream instream = s.getInputStream() ; 
43 OutputStream outstream = s.getOutputStream() ; 
4g 

a // Tarn streams into scanners and writers 

47 Scanner in = new Scanner(Cinstream) ; 

48 PrintWriter out = new PrintWriter(outstream) ; 
49 

50 // Send command 

51 

52 String command = "GET " + resource + " HTTP/1.0\n\n"3 
53 out.printCcommand) ; 

54 out.flushd); 

55 

56 // Read server response 

57 

58 while Cin. hasNextLine()) 

59 

60 String input = in.nextLine(); 

6l System.out.printInCinput) ; 
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62 } 
64 // Always close the socket at the end 


66 s.close(); 
67 } 
68 } 


Output 


Getting / from java.sun.com 

HTTP/1.1 200 OK 

Server: Sun-ONE-Web-Server/6.1 

Date: Wed, 03 Jan 2007 16:16:16 GMT 

Content-type: text/html ;charset=ISO-8859-1 

Set-cookie: JSESSIONID=949E7A2C9191628924868AC4B09F4766; Path=/ 
Connection: close 


<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www .w3.or 

g/TR/htm14/loose.dtd"> 

<html> 

<head> 

<title>Java Technology</title> 


</html> 


SELF CHECK 


5. What happens if you call WebGet with a nonexistent resource, such as 
wombat.htm]l at java.sun.com? 


6. How do you opena socket to read e-mail from the POP server at 
e-mail.sjsu.edu? 


VA See oS 


Now that you have seen how to write a network client, we will turn to the server 
side. In this section we will develop a server program that enables clients to manage 
a set of bank accounts in a bank. 

Whenever you develop a server application, you need to specify some applica- 
tion-level protocol that clients can use to interact with the server. For the purpose 
of this example, we will create a “Simple Bank Access Protocol”. Table 2 shows the 
protocol format. Of course, this is just a toy protocol to show you how to imple- 
ment a server. 

The server program waits for clients to connect to a particular port. We choose 
port 8888 for this service. This number has not been preassigned to another service, 
so it is unlikely to be used by another server program. To listen to incoming 


898 


The Se rverSocket class 


CHAPTER 21 @&® Internet Networking 


Table 2 A Simple Bank Access Protocol 


Client Request Server Response Meaning 
BALANCE 7 n and the balance Get the balance of account 2 
DEPOSIT na n and the new balance Deposit amount a into account 
WITHDRAW 72 a nand the new balance Withdraw amount a from account 7 
QUIT None Quit the connection 


connections, you use a server socket. To construct a server socket, you need to sup- 
ply the port number. 


ServerSocket server = new ServerSocket (8888) ; 


The accept method of the ServerSocket class waits for a client connection. When a 
client connects, then the server program obtains a socket through which it commu- 
nicates with the client. 


Socket s = server.accept(); 
BankService service = new BankService(s, bank); 


The BankService class carries out the service. This class implements 


is used by server _ the Runnable interface, and its run method will be executed in each 
applications to listen for thread that serves a client connection. The run method gets a scanner 
client connections. | and writer from the socket in the same way as we discussed in the 


preceding section. Then it executes the following method: 


public void doService() throws IOException 


: 
while (true) 
if 
if Clin.hasNextQ) return; 
String command = in.next(); 
1f Ccommand.equalsC"QUIT")) return; 
executeCommand(command) ; 
S 
: 


The executeCommand method processes a single command. If the command is 
DEPOSIT, then it carries out the deposit. 


int account = in.nextInt(); 
double amount = in.nextDouble(); 
bank.deposit(account, amount); 


The WITHDRAW command is handled in the same way. After each command, the 
account number and new balance are sent to the client: 


W W 


out.printInCaccount + + bank.getBalance(account)); 


The doService method returns to the run method if the client closed the connection 
or the command equals "QUIT". Then the run method closes the socket and exits. 
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Let us go back to the point where the server socket accepts a connection and con- 
structs the BankService object. At this point, we could simply call the run method. 
But then our server program would have a serious limitation: only one client could 
connect to it at any point in time. To overcome that limitation, server programs 
spawn a new thread whenever a client connects. Each thread is responsible for serv- 
ing one client. 

Our BankService class implements the Runnable interface. Therefore, the server 
program simply starts a thread with the following instructions: 


Thread t = new Thread(service); 
t.start(): 


The thread dies when the client quits or disconnects and the run method exits. In 
the meantime, the BankServer loops back to accept the next connection. 


while (true) 


{ 
Socket s = server.accept() ; 
BankService service = new BankService(s, bank); 
Thread t = new Thread(service); 
t.startQ; 
} 


The server program never stops. When you are done running the server, you need 
to kill it. For example, if you started the server in a shell window, hit Ctrl+C. 

To try out the program, run the server. Then use Telnet to connect to localhost, 
port number 8888. Start typing commands. Here is a typical dialog (see Figure 5): 


DEPOSIT 3 1000 
3 1000.0 
WITHDRAW 3 500 
3 500.0 

QUIT 


File Edit View Terminal Go 
~$§ telnet localhost 8888 
aryine 327.0.0.1... 
Connected to localhost. 
Escape character is '*]'. 
DEPOSIT 3 1000 

3 1000.0 

WITHDRAW 3 500 

3 500.0 


QUIT 


Connection closed by foreign host. 


| | 


Figure 5 Using the Telnet Program to Connect to the Bank Server 
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Alternatively, you can use a client program that connects to the server. You will 


find a sample client program at the end of this section. 


ch21/bank/BankServer.java 


import java.io. IOException; 
import java.net.ServerSocket; 
import java.net.Socket; 


/* * 
A server that executes the Simple Bank Access Protocol. 
=i). 
public class BankServer 
t 
public static void main(String[] args) throws IOException 
{ 
final int ACCOUNTS_LENGTH = 10; 
Bank bank = new Bank(ACCOUNTS LENGTH); 
final int SBAP_PORT = 8888; 
ServerSocket server = new ServerSocket(SBAP_PORT); 
System.out.printInC"Waiting for clients to connect... "); 


while (true) 

{ 
Socket s = server.accept(); 
System.out.printInC"Client connected."); 
BankService service = new BankService(s, bank); 
Thread t = new Thread(service); 
t.starto) ; 


import java.io. InputStream; 
import java.io. IOException; 
import java.io.OutputStream; 
import java.io.PrintWriter; 
import java.net.Socket; 
import java.util.Scanner; 


[** 
Executes Simple Bank Access Protocol commands 
from a socket. 
a] 
public class BankService implements Runnable 
{ 
[** 
Constructs a service object that processes commands 
from a socket for a bank. 
@param aSocket the socket 
@param aBank the bank 
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public BankService(Socket aSocket, Bank aBank) 


{ 
s = aSocket; 
bank = aBank; 
} 
public void run() 
i 
try 
{ 
try 
{ 
in = new Scanner(s.getInputStream()) ; 
out = new PrintWriter(s.getOutputStream()) ; 
doService(); 
} 
finally 
s.closeQ); 
, 
} 
catch (IOException exception) 
{ 
exception.printStackTrace() ; 
$ 
} 


Executes all commands until the QUIT command or the 
end of input. 


public void doService() throws IOException 


while (true) 


{ 
if (lin. hasNextQ) return; 
String command = in.next(); 
if (command.equals('QUIT’)) return; 
else executeCommand(command) ; 
} 


Executes a single command. 
@param command the command to execute 


public void executeCommand(String command) 


{ 


int account = in.nextInt(); 
if (command.equals('DEPOSIT")) 


double amount = in.nextDouble(); 
bank.deposit(account, amount) ; 


} 
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74 else if Ccommand.equals("WITHDRAW" )) 
75 { 
76 double amount = in.nextDouble(): 
ii bank.withdraw(account, amount); 
78 ; 
79 else if (!command.equals("BALANCE" )) 
80 { 
81 out.printInC'Invalid command"); 
82 out.flushQ); 
83 return; 
84 } 
85 Out. printinCaccount +7 ™ + bank.getBalance(account)); 
86 out.flushd; 
87 } 
88 
89 private Socket s; 
90 private Scanner in; 
91 private PrintWriter out; 
92 private Bank bank; 
93 } 
ch21/bank/Bank.java 
l [e% 
2 A bank consisting of multiple bank accounts. 
3 * 
4 public class Bank 
a 
6 pe 
7 Constructs a bank account with a given number of accounts. 
8 @param size the number of accounts 
9 | 
10 public Bank(Gint size) 
11 1 
12 accounts = new BankAccount[size]; 
13 for (int 1 =%; 7 < accounts. length; i++) 
14 accounts[i] = new BankAccount(); 
15 } 
16 
17 [e* 
18 Deposits money into a bank account. 
19 @param accountNumber the account number 
20 @param amount the amount to deposit 
21 oF, 
ee public void depositGint accountNumber, double amount) 
23 if 
24 BankAccount account = accounts[accountNumber]; 
25 account.deposit(amount) ; 
26 } 
ae 
28 ue 
29 Withdraws money from a bank account. 
30 @param accountNumber the account number 
31 @param amount the amount to withdraw 


3 ? a 4 
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33 
34 
35 
36 


public void withdraw(int accountNumber, double amount) 
{ 
BankAccount account = accounts[accountNumber] ; 
account.withdrawCamount) ; 
$ 
Gets the balance of a bank account. 
@param accountNumber the account number 
@return the account balance 
* / 
public double getBalance(int accountNumber) 
{ 
BankAccount account = accounts[accountNumber] ; 
return account.getBalance(); 
$ 
private BankAccount[] accounts; 
} 


ch21 /bank/BankClient.java 


import java.i1o.InputStream; 
import java.io.IOException; 
import java.io.OutputStream; 
import java.io.PrintWriter; 
import java.net.Socket; 
import java.uti].Scanner; 


This program tests the bank server. 


public class BankClient 
1 
public static void main(String[] args) throws IOException 
{ 
final int SBAP_PORT = 8888; 
Socket s = new Socket("localhost" , SBAP_PORT) ; 
InputStream instream = s.getInputStreamQ) ; 
OutputStream outstream = s.getOutputStream() ; 
Scanner in = new Scanner(Cinstream) ; 
PrintWriter out = new PrintWriter(Coutstream) ; 


String command = "DEPOSIT 3 1000\n" ; 
System.out.printC’Sending: " + command) ; 
out.printCcommand) ; 

out.flushd; 

String response = in.nextLine(); 
System.out.printInC"Receiving: " + response) ; 
command = "WITHDRAW 3 500\n"; 
System.out.printC'Sending: ° 
out.print (command) ; 
out.flushQ; 


+ command) ; 
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33 response = in.nextLine(); 

= System.out.printin( Receiving: " + response); 
36 command = "QUIT\n"; 

37 System.out.print( Sending: ' + command); 
38 out.printCcommand) ; 

39 out.flushQ); 

40 

41 s.close(); 

42 

43} 

Output 


Sending: DEPOSIT 3 1000 
Receiving: 3 1000.0 
Sending: WITHDRAW 3 500 
Receiving: 3 500.0 
Sending: QUIT 


SELF CHECK 


7, Why didn’t we choose port 80 for the bank server? 
8. Can you read data from a server socket? 


How To 21.1 


Designing Client/Server Programs 


The bank server of this section is a typical example of a client/server program. A web 
browser/web server is another example. Follow these steps when designing a client/server 
application. 


Step 1 Determine whether it really makes sense to implement a stand-alone server and a 
matching client. 


Many times it makes more sense to build a web application instead. Chapter 24 discusses the 
construction of web applications in detail. For example, the bank application of this section 
could easily be turned into a web application, using an HTML form with Withdraw and 
Deposit buttons. However, programs for chat or peer-to-peer file sharing cannot easily be 
implemented as web applications. 


Step 2 Design a communication protocol. 


Figure out exactly what messages the client and server send to each other and what the suc- 
cess and error responses are. 
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With each request and response, ask yourself how the end of data is indicated. 
© Do the data fit ona single line? Then the end of the line serves as the data terminator. 


© Can the data be terminated by a special line (such as a blank line after the HTTP header or 
a line containing a period in SMTP)? 


° Does the sender of the data close the socket? That’s what a web server does at the end of a 
GET request. 


© Can the sender indicate how many bytes are contained in the request? Web browsers do 
that in POST requests. 


Use text, not binary data, for the communication between client and server. A text-based 
protocol is easier to debug. 


Step 3. Implement the server program. 


The server listens for socket connections and accepts them. It starts a new thread for each 
connection. Supply a class that implements the Runnable interface. The run method receives 
commands, interprets them, and sends responses back to the client. 


Step 4 Test the server with the Telnet program. 
Try out all commands in the communication protocol. 
Step 5 Once the server works, write a client program. 


The client program interacts with the program user, turns user requests into protocol com- 
mands, sends the commands to the server, receives the response, and displays the response 
for the program user. 


21.5 URL Connections | 


The URLConnection class 
makesiteasyto 


In Section 21.3, you saw how to use sockets to connect to a web 
server and how to retrieve information from the server by sending 


ParMmUniCaten With aaweb HTTP commands. However, because HTTP is such an imp- 
server without having to ortant protocol, the Java library contains an URLConnection class, 
issue HTTP commands. which provides convenient support for the HTTP. The 


URLConnection class takes care of the socket connection, so you don’t 
have to fuss with sockets when you want to retrieve from a web server. As an addi- 
tional benefit, the URLConnection class can also handle FTP, the file transfer protocol. 

The URLConnection class makes it very easy to fetch a file from a web server given 
the file’s URL as a string. First, you construct an URL object from the URL in the 
familiar format, starting with the http or ftp prefix. Then you use the URL object's 
openConnection() method to get the URLConnection object itself. 


URL u = new URLC"http://java.sun.com/index.htm!") ; 
URLConnection connection = u.openConnection() ; 


Then you call the getInputStream method to obtain an input stream: 


InputStream instream = connection. getInputStream() ; 
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You can turn the stream into a scanner in the usual way, and read input from the 
scanner. 

The URLConnection class can give you additional useful informa- 
tion. To understand those capabilities, we need to have a closer look 
at HTTP requests and responses. You saw in Section 21.2 that the 
command for getting an item from the server is 


about HTTP requests and GET item HTTP/1.0 


responses. Soe erie pee 


blank line 


You may have wondered why you need to provide a blank line. This 
blank line is a part of the general request format. The first line of the request is a 
command, such as GET or POST. The command may be followed by request proper- 
ties, and some commands ~—in particular, the POST command—send input data to the 
server. The reason for the blank line is to denote the boundary between the request 
property section and the input data section. 
A typical request property is If-Modified-Since. If you request an item with 


GET ztem HTTP/1.0 
If-Modified-Since: date 
blank line 


the server sends the item only if it is newer than the date. Browsers use this feature 
to speed up redisplay of previously loaded web pages. When a web page is loaded, 
the browser stores it in a cache directory. When the user wants to see the same web 
page again, the browser asks the server to get a new page only if it has been modi- 
fied since the date of the cached copy. If it isn’t, the browser simply redisplays the 
cached copy without spending time on downloading another identical copy. 

The uRLConnection class has methods to set request properties. For example, you 
can set the If-Modified-Since property with the setIfModifiedSince method: 


connection. setIfModi fiedSince(date) : 


You need to set request properties before calling the getInputStream method. The 
URLConnection class then sends to the web server all the request properties that you 
set. 

Similarly, the response from the server starts with a status line followed by a set 
of response parameters. The response parameters are terminated by a blank line and 
tollowed by the requested data (for example, an HTML page). Here is a typical 


response: 


HTTP/1.1 200 OK 

Date: Tue, 28 Aug 2007 00:15:48 GMT 

Server: Apache/1.3.3 (Unix) 

Last-Modified: Sat, 23 Jun 2007 20:53:38 GMT 
Content-Length: 4813 

Content-Type: text/html 

blank line 


requested data 


Normally, you don’t see the response code. However, you may have run across bad 
links and seen a page that contained a response code 404 Not Found. (A successful 
response has status 200 OK.) 
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To retrieve the response code, you need to cast the URLConnection object to the 
HttpURLConnection subclass. You can retrieve the response code (such as the number 
200 in this example, or the code 404 if a page was not found) and response message 
with the getResponseCode and getResponseMessage methods: 


HttpURLConnection httpConnection = (HttpURLConnection) connection; 
int code = httpConnection.getResponseCode(); // e.g., 404 
String message = httpConnection.getResponseMessage(); // e.g., “Not found” 


As you can see from the response example, the server sends some information about 
the requested data, such as the content length and the content type. You can request 
this information with methods from the URLConnection class: 


int length = connection.getContentLength() ; 
String type = connection.getContentType() ; 


You need to call these methods after calling the getInputStream method. 

To summarize: You don’t need to use sockets to communicate with a web server, 
and you need not master the details of the HTTP protocol. Simply use the 
URLConnection and HttpURLConnection classes to obtain data from a web server, to set 
request parameters, or to obtain response information. 

The program at the end of this section puts the URLConnection class to work. The 
program fulfills the same purpose as that of Section 21.3—to retrieve a web page 
from a server—but it works at a higher level of abstraction. There is no longer a 
need to issue an explicit GET command. The uRLConnection class takes care of that. 
Similarly, the parsing of the HTTP request and response headers is handled trans- 
parently to the programmer. Our sample program takes advantage of that fact. It 
checks whether the server response code is 200. If not, it exits. You can try that out 
by testing the program with a bad URL, like http://java.sun.com/wombat.htm1. 
Then the program prints a server response, such as 404 Not Found. 

This program completes our introduction into Internet programming with Java. 
You have seen how to use sockets to connect client and server programs. You also saw 
how to use the higher-level URLConnection class to obtain information from web servers. 


ch21/urlget/URLGet.java 


1 import java.io.InputStream; 

2 import java.io. IOException; 

3 import java.io.OutputStream; 

4 import java.io.PrintWriter; 

5 )6cimport java.net.HttpURLConnection; 
6 import java.net.URL; 

7 import java.net.URLConnection; 

8 import java.util.Scanner; 

9 


10: f= 

11 This program demonstrates how to use an URL connection 
12 to communicate with a web server. Supply the URL on 

13 the command-line, for example 

14 java URLGet http://java.sun.com/index.html. 


908 


CHAPTER 21 #8 Internet Networking 


16 public class URLGet 

i7 { 

18 public static void main(String[] args) throws IOException 
19 rf 

20 // Get command-line arguments 

Zi 

Ze String urlString; 

23 if Cargs.length == 1) 

24 urIString = args[0]; 

25 else 

26 { 

Zi urIString = “http://java.sun.com/"; 

28 System.out.printiIn("Using " + urlString); 
29 , 

30 

31 // Open connection 

32 

33 URL u = new URLC(urlString); 

34 URLConnection connection = u.openConnection(); 
35 

36 // Check if response code is HTTP_OK (200) 

37 

38 HttpURLConnection httpConnection 

39 = (HttpURLConnection) connection; 

40 int code = httpConnection.getResponseCode() ; 
41 String message = httpConnection.getResponseMessage(); 
42 System.out.printIn(code + " " + message); 
43 if (code != HttpURLConnection.HTTP_OK) 

4g. return; 

45 

46 // Read server response 

47 

48 InputStream instream = connection.getInputStream(); 
49 Scanner in = new Scanner(instream) ; 

50 

51 while Cin. hasNextLine()) 

52 { 

53 String input = in.nextLineQ; 

54 System.out.printIlnCinput) ; 

55 } 

56 } 

57} 

Output 


Using http://java.sun.com/ 

200 OK 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 
<html> 

<head> 

<title>Java Technology</title> 

</body> 

</htm1> 
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SELF CHECK 


9. Why is it better to use an URLConnection instead of a socket when reading data 
from a web server? 


10. What happens if you use the URLGet program to request an image (such as 
http: //java.sun.com/im/logo_java.gif)? 


PRODUCTIVITY HINT 21.1 


Use High-Level Libraries 


When you communicate with a web server to obtain data, you have two choices. You can 
make a socket connection and send GET and POST commands to the server over the socket. Or 
you can use the URLConnection class and have it issue the commands on your behalf. 

Similarly, to communicate with a mail server, you can write programs that send SMTP 
and POP commands, or you can learn how to use the Java mail extensions. (See [1] for more 
information on the Java Mail API.) 

In such a situation, you may be tempted to use the low-level approach and send com- 
mands over a socket connection. It seems simpler than learning a complex set of classes. 
However, that simplicity is often deceptive. Once you go beyond the simplest cases, the low- 
level approach usually requires hard work. For example, to send binary mail attachments, 
you may need to master complex data encodings. The high-level libraries have all that 
knowledge built in, so you don’t have to reinvent the wheel. 

For that reason, you should not actually use sockets to connect to web servers. Always 
use the URLConnection class instead. Why did this book teach you about sockets if you aren’t 
expected to use them? There are two reasons. Some client programs don’t communicate with 
web or mail servers, and you may need to use sockets when a high-level library is not avail- 
able. And, just as importantly, knowing what the high-level library does under the hood 
helps you understand it better. For the same reason, you saw in Chapter 15 how to imple- 
ment linked lists, even though you probably will never program your own lists and will just 
use the LinkedList class. 
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CHAPTER SUMMARY 


13. 


14. 


. The Internet is a worldwide collection of networks, routing equipment, and 


computers using a common set of protocols to define how each party will 
interact with each other. 


TCP/IP 1s the abbreviation for Transmission Control Protocol over Internet 
Protocol, the pair of communication protocols that is used to establish reliable 
transmission of data between two computers on the Internet. 


A TCP connection requires the Internet addresses and port numbers of both 
end points. 


HTTP, or Hypertext Transfer Protocol, is the protocol that defines communica- 
tion between web browsers and web servers. 


An URL, or Uniform Resource Locator, is a pointer to an information resource 
(such as a web page or an image) on the World Wide Web. 


The Telnet program is a useful tool to establish test connections with servers. 


The HTTP GET command requests information from a web server. The web 
server returns the requested item, which may be a web page, an image, or other 
data. 


A socket 1s an object that encapsulates a TCP connection. To communicate 
with the other end point of the connection, use the input and output streams 
attached to the socket. 


When transmission over a socket is complete, remember to close the socket. 


. For text protocols, turn the socket streams into scanners and writers. 


. Flush the writer attached to a socket at the end of every command. Then the 


command is sent to the server, even if the writer’s buffer isn’t completely filled. 


. The ServerSocket class is used by server applications to listen for client 


connections. 


The URLConnection class makes it easy to communicate with a web server with- 
out having to issue HTTP commands. 


The URLConnection and HttpURLConnection classes can give you additional infor- 
mation about HTTP requests and responses. 


FURTHER READING 


1. http://java.sun.com/products/javamail/index.html JavaMail API information. 


2. http://www.rgpfaq.com/basic-rules.html The basic rules of poker. 


3. http://ww.cia.gov/cia/publications/factbook The CIA World Fact Book. 
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CLASSES, OBJECTS, AND METHODS 
INTRODUCED IN THIS CHAPTER 


java.net.HttpURLConnection 
getResponseCode 
getResponseMessage 
java.net.ServerSocket 
accept 
close 
java.net.Socket 
close 
getInputStream 
getOutputStream 
java.net.URL 
openConnection 
java.net.URLConnection 
getContentLength 
getContentType 
getInputStream 
setIfModi fiedSince 


REVIEW EXERCISES 


Exercise R21.1. What is a server? What is a client? How many clients can connect to 
a server at one time? 


Exercise R21.2. What is a socket? What is the difference between a Socket object and 
a ServerSocket object? 


Exercise R21.3. Under what circumstances would an UnknownHostException be 
thrown? 


Exercise R21.4. What happens if the Socket constructor’s second parameter is not the 
same as the port number at which the server waits for connections? 
Exercise R21.5. When a socket is created, which Internet address is used? 

a. The address of the computer to which you want to connect 


b. The address of your computer 
c. The address of your ISP 


Exercise R21.6. What is the purpose of the accept method of the ServerSocket class? 


Exercise R21.7. After a socket establishes a connection, what mechanism will your 
client program use to read data from the server computer? 

a. The Socket will fill a buffer with bytes. 

b. You will use a Reader obtained from the Socket. 


c. You will use an InputStream obtained from the Socket. 
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* Exercise R21.8. Why is it not common to work directly with the InputStream and 
OutputStream objects obtained from a Socket object? 


* Exercise R21.9. When a client program communicates with a server, it sometimes 
needs to flush the output stream. Explain why. 


* Exercise R21.10. What is the difference between HTTP and HIML? 


* Exercise R21.11. How can you communicate with a web server without using 
sockets? 


* Exercise R21.12. What is the difference between an URL instance and an URLConnection 
instance? 


* Exercise R21.13. What is an URL? How do you create an object of class URL? How 
do you connect to an URL? 


free Additional review exercises are available in WileyPLUS. 
S 


PROGRAMMING EXERCISES 


* Exercise P21.1. Modify the WebGet program to print only the HTTP header of the 
returned HTML page. The HTTP header is the beginning of the response data. It 


consists of several lines, such as 


HTTP/1.1 200 OK 

Date: Tue, 12 Jun 2007 16:10:34 GMT 
Server: Apache/1.3.19 CUnix) 
Cache-Control: max-age=86400 

Expires: Wed, 13 Jun 2007 16:10:34 GMT 
Connection: close 

Content-Type: text/html 


followed by a blank line. 


* Exercise P21.2. Modify the webGet program to print only the title of the returned 
HTML page. An HTML page has the structure 


<html><head><title> . . . </title></head><body> . . . </body></htm1> 


For example, if you run the program by typing at the command line java WebGet 
java.sun.com /, the output should be the title of the root web page at java.sun.com, 
such as The Source for Java(TM) Technology. 


** Exercise P21.3. Modify the BankServer program so that it can be terminated more 
elegantly. Provide another socket on port 8889 through which an administrator can 
log in. Support the commands LOGIN password, STATUS, PASSWORD newPassword, LOGOUT, 
and SHUTDOWN. The STATUS command should display the total number of clients that 
have logged in since the server started. 


xx Exercise P21.4. Modify the BankServer program to provide complete error checking. 
For example, checking to make sure that there is enough money in the account 
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when withdrawing. Send appropriate error reports back to the client. Enhance the 
protocol to be similar to HTTP, in which each server response starts with a number 
indicating the success or failure condition, followed by a string with response data 
or an error description. 


Exercise P21.5. Write a client application that executes an infinite loop that does the 
following: (a) prompts the user for a number, (4) sends that value to the server, (c) 
receives the number, and (d) displays the new number. Also write a server that exe- 
cutes an infinite loop whose body accepts a client connection, reads a number from 
the client, computes its square root, and writes the result to the client. 


Exercise P21.6. Implement a client-server program in which the client will print the 
date and time given by the server. Two classes should be implemented: DateClient 
and DateServer. The DateServer simply prints new Date().toString() whenever it 
accepts a connection and then closes the socket. 


Exercise P21.7. Write a program to display the protocol, host, port, and file compo- 
nents of an URL. Hint: Look at the API documentation of the URL class. 


Exercise P21.8. Write a simple web server that recognizes only the GET request. When 
a client connects to your server and sends a command, such as GET filename HTTP/ 
1.0, then return a header 


HTTP/1.1 200 OK 


followed by a blank line and all lines in the file. If the file doesn’t exist, return 404 
Not Found instead. 


Your server should listen to port 8080. Test your web server by starting up your 
web browser and loading a page, such as localhost: 8080/c:\cs1\myfile.htm1. 


Exercise P21.9. Write a chat server and client program. The chat server accepts con- 
nections from clients. Whenever one of the clients sends a chat message, it is dis- 
played for all other clients to see. Use a protocol with three commands: LOGIN 
name, CHAT message, and LOGOUT. 


Exercise P21.10. A query such as 
http: //mach.usno.navy.mil/cgi-bin/aa_moonphases?year=2006 


returns a page containing the moon phases in a given year. Write a program that 
asks the user for a year, month, and day and then prints the phase of the moon on 


that day. 


Additional programming exercises are available in WileyPLUS. 
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PROGRAMMING PROJECTS 


Project 21.1. Write a program that allows several people to play a networked game. 
Each player connects to a game server. Each player’s move is transmitted to the 
game server. The game server checks that the move is valid and informs all client 
programs of the updated game status. 


You can either implement your favorite multiplayer game, or simply use Poker (see 
[2] for the rules). Extra credit if your code is structured to separate the generic 
mechanism that is required for all games and the specific rules of a particular game. 


Project 21.2. Write a program that allows a user to query the CIA World Fact Book 
[3] for facts about a country, such as the size, average income, capital city, and so on. 
To get the answers for user queries, connect to the web site, retrieve the web page, 
and extract the requested information. You will find that task simpler if you access 
the text version of the fact book. 


ANSWERS TO SELF-CHECK QUESTIONS 


1. An IP address is a numerical address, consisting of four or sixteen bytes. A 
domain name is an alphanumeric string that is associated with an IP address. 


2. TCP is reliable but somewhat slow. When sending sounds or images in real 
time, it is acceptable if a small amount of the data is lost. But there is no point in 
transmitting data that is late. 

3. The browser software translates your requests (typed URLs and mouse clicks 
on links) into HTTP commands that it sends to the appropriate web servers. 


4. Some Telnet implementations send all keystrokes that you type to the server, 
including the backspace key. The server does not recognize a character sequence 
such as G W Backspace E T as a valid command. 


5. The program makes a connection to the server, sends the GET request, and prints 
the error message that the server returns. 
6. Socket s = new Socket("e-mail.sjsu.edu", 110); 


7. Port 80 is the standard port for HTTP. If a web server is running on the same 
computer, then one can’t open a server socket on an open port. 

8. No, a server socket just waits for a connection and yields a regular Socket object 
when a client has nee. You use that socket object to read the data that a 
client sends. 


9. ‘The URLConnection class understands the HTTP protocol, freeing you from 
assembling requests and analyzing response headers. 


10. The bytes that encode the images are displayed on the console, but they will 
appear to be random gibberish. 


CHAPTER GOALS 


=o 
eS haeeee 


Chapter 


Relational 
Databases 


To understand how relational databases store information 


To learn how to query a database with the Structured 
Query Language (SQL) 


To connect to databases with Java Database Connectivity JDBC) 


To write database programs that insert, update, and query data 
in a relational database 


ln Chapter 19 you saw how to store data in a file. When you store data, you will 
want to be able to add more data items, remove data, change data items, and find 
items that match certain criteria. However, if you have a lot of data, it can be 
difficult to carry out these operations quickly and efficiently. Because data storage 
is such a common task, special database management systems (DBMS) have been 
invented that let the programmer think in terms of the data rather than file storage. 
In this chapter you will learn how to use SQL, the Structured Query Language, to 
query and update information in a relational database, and how to access database 


information from Java programs. 
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A relational database stores information in tables. Figure 1 shows a 
typical table. As you can see, each row in this table corresponds to a 
product. The column headers correspond to attributes of the product: 
the product code, description, and unit price. Note that all items in a 
particular column have the same type: product codes and descriptions 
are strings, unit prices are floating-point numbers. The allowable column types dif- 
fer somewhat from one database to another. Table 1 shows types that are commonly 
available in relational databases that follow the SQL (for Structured Query Lan- 
guage; often pronounced “sequel”) standard. (See A Guide to the SQL Standard [1] 


for more information.) 


“has shames and. a data type. 


Product 
Product_Code Description Price 
116-064 Toaster 24.95 
257-535 Hair dryer 29.95 
643-119 Car vacuum 19.99 


Figure 1 A Product Table in a Relational Database 
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Table 1 Some Standard SQL Types and Their Corresponding Java Types 


SQL Data Type Java Data Type 
INTEGER or INT Int 
REAL Float 
DOUBLE double 
DECIMAL (m, 7) Fixed-point decimal numbers with m total digits and n digits after the 


decimal point; similar to BigDecimal. 


BOOLEAN boolean 
CHARACTER (72) or CHAR (7) Fixed-length string of length n; similar to String. 

SSO Girucured Guan Most relational databases follow the SQL standard. There is no 

LAGU) en Can relationship between SQL and Java—they are different languages. 
language for interacting However, as you will see later in this chapter, you can use Java to 
with adatabase. send SQL commands to a database. You will see in the next section 
ease | how to use SQL commands to carry out queries, but there are other 

SQL commands. 

Wiehe eC For example, here is the SQL command to create a product table: 
‘CREATE TABLE and CREATE TABLE Product 
_ INSERT INTO to add data > C 


Te dalabace ee Product_Code CHAR(11), 
ees : : Description CHAR(40), 
Price DECIMAL(10, 2) 

) 


Unlike Java, SQL is not case sensitive. For example, you could spell the command 
create table instead of CREATE TABLE. However, as a matter of convention, we will 
use uppercase letters for SQL keywords and mixed case for table and column 
names. 

To insert rows into the table, use the INSERT INTO command. Issue one command 
for each row, such as 


INSERT INTO Product 
VALUES (€'257-535', 'Hair dryer', 29.95) 


SQL uses single quotes ('), not double quotes, to delimit strings. What if you have a 
string that contains a single quote? Rather than using an escape sequence (such as 
\') as in Java, you just write the single quote twice, such as 


"Sam''s Small Appliances' 


If you create a table and subsequently want to remove it, use the DROP TABLE com- 
mand. For example, 


DROP TABLE Test 
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PRODUCTIVITY HINT 22.1 
Stick with the Standard 


The Java language is highly standardized. You will rarely find compilers that allow you to 
specify Java code that differs from the standard, and if they do, it is always a compiler bug. 
However, SQL implementations are often much more forgiving. For example, many SQL 
vendors allow you to use a Java-style escape sequence such as 


"Sam\'s Small Appliances' 
in a SQL string. The vendor probably thought that this would be “helpful” to programmers 


who are familiar with Java or C. (The C language uses the same escape mechanism for denot- 
ing special characters.) 

However, this is an illusion. Deviating from the standard limits portability. Suppose you 
later want to move your database code to another vendor, perhaps to improve performance 
or to lower the cost of the database software. If the other vendor hasn’t implemented a par- 
ticular deviation, then your code will no longer work and you need to spend time fixing it. 

To avoid these problems, you should stick with the standard. With SQL, you cannot rely 
on your database to flag all errors—some of them may be considered “helpful” extensions. 
That means that you need to know the standard and have the discipline to follow it. 


22.1.2 Linki 
gst aS fe lo oo as. ‘] Hi a 3 (ay 
ST Peale ES eS Pog TEL : = 9 


— a 
ea te 


bast Aas fiero 
pare Soe ae Pinas Feet 


If you have objects whose instance fields are strings, numbers, dates, or other types 
that are permissible as table column types, then you can easily store them as rows in 
a database table. For example, consider a Java class Customer: 


public class Customer 


{ 
private String name; 
private String address; 
private String city; 
private String state; 
private String zip; 

} 


It is simple to come up with a database table structure that allows you to store cus- 
tomers—see Figure 2. 


Customer 
Name Address City State Zip 
CHAR (40) CHAR (40) CHAR (30) CHAR (2) CHAR (10) 
Sam’s Small Appliances 100 Main Street Anytown Gus. 98765 


Figure 2 A Customer Table 
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Invoice 
invoice _ Customer __ Customer _ Customer _ Customer _ Customer _ 
Number Name Address City State Zip 


INTEGER CHAR (40) CHAR (40)  CHAR(30) CHAR(2) CHAR(10) 


11734 


11732 


11733 


You should evo rows | 
with replicated data. 
Instead, distribute he 
data over multiple tables 


Sam’s Small 100 Main Street Anytown CA 98765 
Appliances 
Electronics 1175 Liberty Ave Pleasantville MI 45066 
Unlimited 
Sam’s Small 100 Main Street Anytown CA 98765 
Appliances 


Figure 3 A Poor Design for an Invoice Table with Replicated Customer Data 


For other objects, it is not so easy. Consider an invoice. Each invoice object con- 
tains a reference to a customer object. 


public class Invoice 


{ 


private int invoiceNumber; 
private Customer theCustomer; 


: 


Because Customer isn’t a standard SQL type, you might consider simply entering all 
the customer data into the invoice tables—see Figure 3. However, this is not a good 
idea. If you look at the sample data in Figure 3, you will notice that Sam’s Small 
Appliances had two invoices, number 11731 sad 11733. Yet all information for the 
customer was replicated in two rows. 

This replication has two problems. First, it is wasteful to store the same informa- 
tion multiple times. If the same customer places many orders, then the replicated 
information can take up a lot of space. More importantly, the replication is danger- 
ous. Suppose the customer moves to a new address. Then it would be an easy mis- 
take to update the customer information in some of the invoice records and leave 
the old address in place in others. 

In a Java program, neither of these problems occurs. Multiple Invoice objects can 
contain references to a single shared Customer object. 

The first step in achieving the same effect in a database 1s to orga- 
nize your data into multiple tables as in Figure 4. Dividing the col- 
umns into two tables solves the replication problem. The customer 
data are no longer replicated—the Invoice table contains no cus- 
tomer information, and the Customer table contains a single record 
for each customer. But how can we refer to the customer to which an invoice 1s 
issued? Notice in Figure 4 that there is now a Customer_Number column in both 
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Invoice 
Nees Customer_ Payment 
umber Number 3 
INTEGER INTEGER DECIMAL (10, 2) 
11731 3175 0 
11732 3176 249.95 
11733 3175 0 
Customer 
a Name Address City State Zip 
INTEGER CHAR (40) CHAR (40) CHAR (30) “CHAR Q) “CHAR (0) 
3175 Sam’s Small Appliances 100 Main Street Anytown CA 98765 
3176 Electronics Unlimited 1175 Liberty Ave Pleasantville MI 45066 


Figure 4 Two Tables for Invoice and Customer Data 


the Customer table and the Invoice table. Now all invoices for Sam’s Small 
Appliances share only the customer number. The two tables are linked by the 
Customer_Number field. To find out more details about this customer, you need to 
use the customer number to look up the customer in the Customer table. 

Note that the customer number is a unique identifier. We introduced the cus- 
tomer number because the customer name by itself may not be unique. For exam- 
ple, there may well be multiple Electronics Unlimited stores in various locations. 
Thus, the customer name alone does not uniquely identify a record, so we cannot 
use the name as a link between the two tables. 

In database terminology, a column (or combination of columns) 
that uniquely identifies a row in a table is called a primary key. In our 
Customer table, the Customer_Number column is a primary key. Not 
dill database tables need 4 primary key. You need a primary key if you 
want to establish a link from another table. For example, the Customer 
table needs a primary key so that you can link customers to invoices. 

When a primary key is linked to another table, the matching col- 
umn (or combination of columns) in that table is called a forezgn key. 
For example, the Customer_Number in the Invoice table is a foreign 
key, linked to the primary key in the Customer table. Unlike primary 
Levis foreign keys need not be unique. For example, in our Invoice table we have 
several records that have the same value for the Customer_Number foreign key. 


| table. record. 
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PRODUCTIVITY HINT 22.2 
Avoid Unnecessary Data Replication 


It is very common for beginning database designers to replicate data. When replicating data 
in a table, ask yourself if you can move the replicated data into a separate table and use a key, 
such as a code or ID number, to link the tables. 

Consider this example in an Invoice table: 


invoice 
Product_Code Description Price 
CHAR (10) CHAR (40) DECIMAL (10, 2) 
116-064 Toaster 24.95 
116-064 Toaster 24.95 


As you can see, some product information is replicated. Is this replication an error? It 
depends. The product description for the product with code 116-064 is always going to be 
“Toaster”. Therefore, that correspondence should be stored in an external Product table. 

The product price, however, can change over time. When it does, the old invoices don’t 
automatically use the new price. Thus, it makes sense to store the price that the customer was 
actually charged in an Invoice table. The current list price, however, is best stored in an 
external Product table. 


ADVANCED TOPIC 22.1 


Primary Keys and Indexes 


Recall that a primary key is a column (or combination of columns) that uniquely identifies a 
row in a table. When a table has a primary key, then the database can build an index file: a file 
that stores information on how to access a row quickly when the primary key is known. 
Indexing can greatly increase the speed of database queries. 

If the primary key is contained in a single column, then you can tag the column with the 
PRIMARY KEY attribute, like this: 


CREATE TABLE Product 


C 
Product_Code CHAR(10) PRIMARY KEY, 
Description CHAR(40), 
Price DECIMAL(10, 2) 

) 
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Invoice 


Invoice __ 
Number 


INTEGER 


11731 
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If the primary key is contained in multiple columns, then add a PRIMARY KEY clause to the end 
of the CREATE TABLE command, like this: 


CREATE TABLE LineItem 


( 
Invoice _Number INTEGER, 
Product_Code CHAR(10), 
Quantity INTEGER, 
PRIMARY KEY (Invoice_Number, Product_Code) 


) 


Occasionally, one can speed queries up by building secondary indexes: index files that index 
other column sets, which are not necessarily unique. That is an advanced technique that we 
will not discuss here. 


iplementing Multi-Valued Relationships 


Each invoice is linked to exactly one customer. That is called a single- valued 
relationship. On the other hand, each invoice has many line items. (As in Chapter 
12, a line item identifies the product, quantity, and unit price.) Thus, there is a 
multi-valued relationship between invoices and line items. In the Java class, the 
LineItem objects are stored in an array list: 


public class Invoice 


{ 
private int invoiceNumber; 
private Customer theCustomer; 
private ArrayList<LineItem> items; 
private double payment; 

i 


However, in a relational database, you need to store the information in tables. Sur- 
prisingly many programmers, when faced with this situation, commit a major faux 
pas and replicate columns, one for each line item, as in Figure 5. 

Clearly, this design is not satisfactory. What should we do if there are more than 
three line items on an invoice? Perhaps we should have 10 line items instead? But 


Customer _ Product_ : Product_ ; Product : 
Number Code Quantity1 Code2 Quantity2 Code3_ Quantity3 Payment 


INTEGER CHAR (10). “INTEGER. CHAR(0). INTEGER GHAR(0)  INIEGER —DECIMAT (10; 2) 


3175 116-064 8) 257-535 1 643-119 2 0 


Figure 5 A Poor Design for an Invoice Table with Replicated Columns 
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that is wasteful if the majority of invoices have only a couple of line items, and it 
still does not solve our problem for the occasional invoice with lots of line items. 
Instead, distribute the information into two tables: one for invoices and another 
for line items. Link each line item back to its invoice with an Invoice_Number for- 
eign key in the Lineltem table—see Figure 6. 
Our database now consists of four tables: 


e Invoice 

e Customer 

e Lineltem 

e Product 

Figure 7 shows the links between these tables. In the next section you will see how 


to query this database for information about invoices, customers, and products. The 
queries will take advantage of the links between the tables. 


invoice 
Invoice Number Customer_Number Payment 
INTEGER INTEGER DECIMAL (10, 2) 
£1751 3175 0 
1T732 3176 249.50 
£1733 3175 0 
Lineltem 
invoice_Number Product_Code Quantity 
INTEGER CHAR (10) INTEGER 
11731 116-064 3 
11751 257-535 1 
£1731 643-119 2 
11732 116-064 10 
11733 116-064 2 
£1799 643-119 1 


Figure 6 Linked Invoice and Lineltem Tables Implement a 
Multi-Valued Relationship 
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: Customer_Number 
Invoice Sieseeyueninw near Customer 


Invoice. Number 
Lineltem 


Product_Code 


Product 


Figure 7 The Links Between the Tables in the Sample Database 


SELF CHECK 


1. Would a telephone number be a good primary key for a customer table? 


2. In the database of Section 22.1.3, what are all the products that customer 3176 
ordered? 


PRODUCTIVITY HINT 22.3 
Don’t Replicate Columns in a Table 


If you find yourself numbering columns in a table with suffixes 1, 2, and so forth (such as 
Quantity1, Quantity2, Quantity3 in the preceding example), then you are probably on the 
wrong track. How do you know there are exactly three quantities? In that case, it’s time for 
another table. 

Add a table to hold the information for which you replicated the columns. In that table, 
add a column that links back to a key in the first table, such as the invoice number in our 
example. By using an additional table, you can implement a multi-valued relationship. 
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Let us assume that the tables in our database have been created and that records 
have been inserted. Once a database is filled with data, you will want to query the 
database for information, such as 


e What are the names and addresses of all customers? 

e What are the names and addresses of all customers in California? 

e What are the names and addresses of all customers who buy toasters? 

e What are the names and addresses of all customers with unpaid invoices? 


In this section you will learn how to formulate simple and complex queries in SQL. 
We will use the data shown in Figure 8 for our examples. 


Invoice Lineltem 
ee Customer_ Payment Invoice_ Product_ Quantity 
umber Number Number Code 
INTEGER.  INIEGER, DECIMAL €o, 2) INTEGER CHAR (0) INIEGER 
11734 9175 0 11731 116-064 3) 
11732 3176 249.50 11731 257-535 1 
11733 3175 0 11731 643-119 2 
Product 11732 116-064 10 
Product_Code Description Price 11733 116-064 2 
CHAR (10) CHAR (40) © DECIMAL (10, 2) 11733 643-119 1 
116-064 Toaster 24.95 
257-535 Hair dryer 29.95 
643-119 Car vacuum 19.99 
Customer 
une : = Name Address City State Zip 
INTEGER CHAR (40) CHAR (40) CHAR G0) CHAR(@). CHAR (10) 
3175 Sam’s Small Appliances 100 Main Street Anytown CA 98765 
3176 Electronics Unlimited 1175 Liberty Ave Pleasantville MI 45066 


Figure 8 A Sample Database 


926 CHAPTER 22 Relational Databases 


In SQL, you use the SELECT command to issue queries. For example, 
the command to select all data from the Customer table is 


SELECT * FROM Customer 


Use the SQL SELEC 


database. 


The result is 


Customer_ 
Nuabe; Name Address City State Zip 
3175 Sam’s Small 100 Main Street Anytown CA 98765 
Appliances 
3176 Electronics 1175 Liberty Ave Pleasantville MI 45066 
Unlimited 


The outcome of the query is a view—a set of rows and columns that provides a 
“window” through which you can see some of the database data. If you select all 
rows and columns froma single table, of course you get a view into just that table. 

Many database systems have tools that let you issue interactive SQL com- 
mands—Figure 9 shows a typical example. When you issue a SELECT command, the 
tool displays the resulting view. You may want to skip ahead to Section 22.3 and 
install a database. Or perhaps your computer lab has a database installed already. 
Then you can run the interactive SQL tool of your database and try out some 
queries. 
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Often, you don’t care about all columns in a table. Suppose your traveling salesper- 
son is planning a trip to all customers. To plan the route, the salesperson wants to 
know the cities and states of all customers. Here is the query: 


SELECT City, State FROM Customer 
The result is 


City State 


Anytown CA 
Pleasantville MI 


As you can see, the syntax for selecting columns is straightforward. Simply specify 
the names of the columns you want, separated by commas. 
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You just saw how you can restrict a view to show selected columns. Sometimes you 
want to select certain rows that fit a particular criterion. For example, you may 
want to find all customers in California. Whenever you want to select a subset, you 
| use the WHERE clause, followed by the condition that describes the subset. Here 1s an 
| example. 


SELECT * FROM Customer WHERE State = 'CA' 
The result is | 


Customer _ 


Number Name Address City State Zip 


| 3175 Sam’s Small 100 Main Street Anytown CA 98765 
| Appliances 
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You have to be a bit careful with expressing the condition in the WHERE clause, 
because SQL syntax differs from the Java syntax. As you already know, in SQL you 
use single quotes to delimit strings, such as 'CA'. You also use a single =, not a dou- 
ble ==, to test for equality. To test for inequality, you use the <> operator. For 
example 


SELECT * FROM Customer WHERE State <> 'CA' 


selects all customers that are not in California. 

You can match patterns with the LIKE operator. The right-hand side must be a 
string that can contain the special symbols _ (match exactly one character) and % 
(match any character sequence). For example, the expression 


Name LIKE ' 0%' 


matches all strings whose second character is an “o”. Thus, “Toaster” is a match but 
“Crowbar” is not. 
You can combine expressions with the logical connectives AND, OR, and NOT. (Do 
not use the Java && ||, and ! operators.) For example, 
SELECT * 
FROM Product 


WHERE Price < 100 
AND Description <> 'Toaster' 


selects all products whose price is less than 100 that are not toasters. 
Of course, you can select both row and column subsets, such as 


SELECT Name, City FROM Customer WHERE State = 'CA' 
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Suppose you want to find out how many customers there are in California. Use the 
COUNT function: 


SELECT COUNTC*) FROM Customer WHERE State = 'CA' 


In addition to the COUNT function, there are four other functions: SUM, AVG (average), 
MAX, and MIN. 

The * means that you want to calculate entire records. That is appropriate only 
for the COUNT function. For other functions, you have to access a specific column. 
Put the column name inside the parentheses: 


SELECT AVGCPrice) FROM Product 
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The queries that you have seen so far all involve a single table. However, usually, the 
information that you want is distributed over multiple tables. For example, suppose 
you are asked to find all invoices that include a line item for a car vacuum. From the 
Product table, you can issue a query to find the product code: 


A join is a query that 
involves multiple tables. 
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SELECT Product_Code 
FROM Product 
WHERE Description = 'Car vacuum' 


You will find out that the car vacuum has product code 643-119. Then you can issue 
a second query 


SELECT Invoice Number 
FROM LineItem 
WHERE Product_Code = '643-119' 


But it makes sense to combine these two queries so that you don’t have to keep 
track of the intermediate result. When combining queries, note that the two tables 
are linked by the Product_Code field. We want to look at matching rows in both 
tables. In other words, we want to restrict the search to rows where 


Product.Product_Code = Lineltem.Product_Code 
Here, the syntax 
TableName.ColumnName 


denotes the column in a particular table. Whenever a query involves multiple tables, 
you should specify both the table name and the column name. Thus, the combined 
query is 
SELECT LineItem.Invoice_Number 
FROM Product, LineItem 


WHERE Product.Description = 'Car vacuum’ 
AND Product.Product_Code = LineItem.Product_Code 


The result is 


Invoice Number 
11731 
11:733 


In this query, the FROM clause contains the names of multiple tables, 
separated by commas. (It doesn’t matter in which order you list the 
tables.) Such a query is often called a join because it involves joining 
multiple tables. 

You may want to know in what cities hair dryers are popular. Now you need to 
add the Customer table to the query —it contains the customer addresses. The cus- 
tomers are referenced by invoices, so you need that table as well. Here is the com- 
plete query: 

SELECT Customer.City, Customer.State, Customer.Zip 

FROM Product, LineItem, Invoice, Customer 
WHERE Product.Description = ‘Hair dryer' 
AND Product.Product Code = LineItem.Product_Code 


AND LineItem.Invoice Number = Invoice. Invoice_Number 
AND Invoice.Customer_Number = Customer.Customer_Number 


930 
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The result is 
City State Zip 


Anytown CA 98765 


Whenever you formulate a query that involves multiple tables, remember to: 


e List all tables that are involved in the query in the FROM clause. 
¢ Use the TableName.ColumnName syntax to refer to column names. 


e List all join conditions (TableName1.ColumnNamel1 = 
TableName2.ColumnName2) in the WHERE clause. 


As you can see, these queries can get a bit complex. However, databases are very 
good at answering these queries (see Productivity Hint 22.4). One remarkable 
aspect of SQL is that you tell the database what you want, not how it should find 
the answer. It is entirely up to the database to come up with a plan for how to find 
the answer to your query in the shortest number of steps. Commercial database 
manufacturers take great pride in coming up with clever ways to speed up queries: 
query optimization strategies, caching of prior results, and so on. In this regard, 
SQL is a very different language from Java. SQL statements are descriptive and 
leave it to the database to determine how to execute them. Java statements are pre- 
scriptive—you spell out exactly the steps you want your program to carry out. 


COMMON ERROR 22.1 


Joining Tables Without Specifying a Link Condition 


If you select data from multiple tables without a restriction, the result is somewhat surpris- 
ing —you get a result set containing all combinations of the values, whether or not one of the 
combinations exists with actual data. For example, the query 


SELECT Invoice.Invoice_ Number, Customer.Name 
FROM Invoice, Customer 


returns the result set 


Invoice.Invoice_Number Customer.Name 
11731 Sam’s Small Appliances 
11732 Sam’s Small Appliances 
{1733 Sam’s Small Appliances 
11731 Electronics Unlimited 
11732 Electronics Unlimited 


11733 Electronics Unlimited 
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As you can see, the result set contains all six combinations of invoice numbers (11731, 11732, 
11733) and customer names (Sam’s Small Appliances and Electronics Unlimited), even 
though three of those combinations don’t occur with real invoices. You need to supply a 
WHERE clause to restrict the set of combinations. For example, 


SELECT Invoice.Invoice_Number, Customer.Name 
FROM Invoice, Customer 
WHERE Invoice.Customer Number = Customer.Customer_Number 


yields 
Invoice.Invoice_Number Customer.Name 
11731 Sam’s Small Appliances 
11732 Electronics Unlimited 
11733 Sam’s Small Appliances 


22.2.6 Updati i 
22.2.6 Updating and Deleting Data 
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ippeeecieeee «Up to now, you have been shown how to formulate increasingly 

SOL commands modify the complex SELECT queries. The outcome of a SELECT query is a result set 

“datainadatabase. .~—”-—«sthat ~you can view and analyze. Iwo related statement types, UPDATE 

and DELETE, don’t produce a result set. Instead, they modify the data- 

base. The DELETE statement is the easier of the two. It simply deletes the 

rows that you specify. For example, to delete all customers in California, you issue 
the statement 


DELETE FROM Customer WHERE State = 'CA' 


The UPDATE query allows you to update columns of all records that fulfill a certain 
condition. For example, here is how you can add another unit to the quantity of 
every line item in invoice number 11731. 
UPDATE LineItem 
SET Quantity = Quantity + 1 
WHERE Invoice_Number = '11731' 
You can update multiple column values by specifying multiple update expressions 
in the SET clause, separated by commas. 
Both the DELETE and the UPDATE statements return a value, namely the number of 
rows that are deleted or updated. 


SELF CHECK 


3. How do you query the names of all customers that are not from Alaska or 
Hawaii? 


4. How do you query all invoice numbers of all customers in Hawai? 


932 


CHAPTER 22 28 Relational Databases 


RANDOM FACT 22.1 
Databases and Privacy 


Most companies use computers to keep huge data files of customer records and other busi- 
ness information. Databases not only lower the cost of doing business; they improve the 
quality of service that companies can offer. Nowadays it is almost unimaginable how time- 
consuming it used to be to withdraw money from a bank branch or to make travel 
reservations. 

Many companies collect large amounts of data on their customers and often share the data 
with other companies. The data are used not just for good customer service but for other 
commercial purposes—for example, to select targets for advertising. A company may have a 
file of addresses of car owners and a file of people with good payment history. It can then 
send special offers to all of its customers who placed an order in the last month, drive an 
expensive car, and pay their bills on time. 

This kind of query is, of course, much faster if all customer files use the same key, which is 
why so many organizations in the United States try to collect the Social Security numbers of 
their customers. 

The Social Security Act of 1935 provided that each contributor be assigned a Social Secu- 
rity number to track contributions into the Social Security Fund. These numbers have a dis- 
tinctive format, such as 078-05-1120. (This particular number was printed on sample cards 
that were inserted in wallets. It actually was the Social Security number of the secretary of a 
vice president at the wallet manufacturer. When thousands of people used it as their own, the 
number was voided, and the secretary received a new number. For more information, see 
http: //www.ssa.gov/history/ssn/misused. html.) Figure 10 shows a Social Security card. 

Although they were not intended for use as a universal identification number, Social 
Security numbers have become just that in the last 60 years. The tax authorities and many 
other government agencies are required to collect the numbers, as are banks (for the report- 
ing of interest income) and, of course, employers. Many other organizations find it conve- 
nient to use the number as well. 

From a technical standpoint, Social Security numbers are a lousy method for indexing a 
database. There is a risk of having two records with the same number, because many illegal 
immigrants use fake numbers. Not everyone has a number—in particular, foreign customers. 
Because there is no checksum, a clerical error (such as transposing two digits) cannot be 
detected. (Credit card numbers have a checksum.) For the same reason, it is easy for anyone 
to make up a number. 


O73=05=Li20 


THIS NUMBER HAS BEEN ESTABLISHED FOR 


JOHN DOE 


Figure 10 A Social Security Card 
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Some people are very concerned about the fact that just about every organization wants 
to store their Social Security number. Unless there is a legal requirement, such as for banks, 
one can usually fight it or take one’s business elsewhere. Even when an organization 1s 
required to collect the number, such as an employer, one can insist that the number be used 
only on tax and Social Security paperwork, not on the face of an ID card. Unfortunately, it 
usually takes near-superhuman effort to climb the organizational ladder to find someone 
with the authority to process paperwork with no Social Security number or to assign 
another identification number. 

As the Internet becomes a more pervasive part of our lives, you can witness firsthand the 
voracious appetite for personal information by marketers of products and services. There are 
many opportunities to obtain free services (such as free e-mail), if you are willing to divulge 
some personal information, and if you agree to the monitoring of your browsing and pur- 
chasing habits. 

The discomfort that many people have about the computerization of their personal infor- 
mation is understandable. There is the possibility that companies and the government can 
merge multiple databases and derive information about us that we may wish they did not 
have or that simply may be untrue. An insurance company may deny coverage, or charge a 
higher premium, if it finds that you have too many relatives with a certain disease. You may 
be denied a job because of an inaccurate credit or medical report, and you may not even 
know the reason. These are very disturbing developments that have had a very negative 
impact for a small but growing number of people. See [2] and [3] for more information. 


A wide variety of database systems are available. Among them are 


High-performance commercial databases, such as Oracle, IBM DB2, or 
Microsoft SQL Server 


© Open-source databases, such as PostgreSQL or MySQL 
e Lightweight Java databases, such as Apache Derby 


Desktop databases, such as Microsoft Access 


Which one should you choose for learning database programming? That depends 
greatly on your available budget, computing resources, and experience with install- 
ing complex software. In a laboratory environment with a trained administrator, it 
makes a lot of sense to install a commercial database, such as Oracle, but the prod- 
ucts themselves, the hardware to run them, and the staff to administer them are 
expensive. Open-source alternatives are available free of charge, and their quality 
has greatly increased in recent years. Although they may not be suited for large- 
scale applications, they work fine for learning purposes. However, installation 1s 
generally not for the faint of heart. Lightweight Java databases are much easier to 
install and work on a variety of platforms. This makes them a good choice for the 
beginner. Desktop databases have limited SQL support and can be difficult to con- 
figure for Java programming. 
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Database Database 


Server Tables 


Figure 11 JDBC Architecture 


In addition to a database, you need a JDBC driver. The acronym 

_ JDBC stands for Java Database Connectivity, the name of the technol- 
ogy that enables Java programs to interact with databases. When your 
Java program issues SQL commands, the driver forwards them to the 

database and lets your program analyze the results (see Figure 11). 

Ditferent databases require different drivers, which may be supplied by either the 
database manufacturer or a third party. You need to locate and install the driver that 
matches your database. 

If you work in a computing laboratory, someone will have installed a database 
for you, and you should ask your lab for instructions on how to use it. If you install 
your own database, we recommend that you start out with the lightweight Apache 
Derby database. Java 6 includes Apache Derby, branded as “JavaDB”. If you use an 
earlier version of Java, you can download Apache Derby from [4]. 

You should run a test program to check that your database is working correctly. 
You will find the code for the test program at the end of this section. The following 
section describes the implementation of the test program in detail. 

If you use Apache Derby, then follow these simple instructions. 


1. Locate the JDBC driver file derby. jar and copy it into the ch22/test direc- 
tory of the companion code for this book. If you use Java 6, you will find the 
driver file in the db/1ib directory of your Java installation. 


2. Open acommand shell, change to the ch22/test directory, and run 


jJavac TestDB.java 
java -classpath derby.jar;. TestDB database.properties 


If you run Linux, Unix, or Mac OS, change the semicolon to a colon: 
java -classpath derby.jar:. TestDB database.properties 


3. If you followed the test instructions precisely, you should see one line of out- 
put with the name “Romeo”. You may then skip the remainder of this section. 


If you install a database other than the one included with Java, you will need to 
set aside some time to carry out the installation process. Detailed instructions for 
installing a database vary widely. Here we give you a general sequence of steps on 
how to install a database and test your installation. 


1, Obtain the database program, either on CD-ROM or by downloading it from 
the Web. 


2. Read the installation instructions. 
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3. Install the program. This may be as simple as running an installation program, 
or you may need to recompile the program from its source code. 


4. Start the database. With most database systems (but not some of the light- 
weight Java database systems), you need to start the database server betore 
you can carry out any database operations. Read the installation instructions 
for details. 


5. Set up user accounts. This typically involves running an administration pro- 
gram, logging in as administrator with a default administration account, and 
adding user names and passwords. If you are the only user of the database, 
you may simply be able to use a default account. Again, details vary greatly 
among databases, and you should consult the documentation. 


6. Runatest. Most databases come with a program that allows you to execute 
interactive SQL instructions. Locate that program and find out how to log on 
as a database user. Then run the following SQL instructions: 


CREATE TABLE Test (Name CHAR(20)) 
INSERT INTO Test VALUES ('Romeo') 
SELECT * FROM Test 

DROP TABLE Test 


At this point, you should get a display that shows a single row and column of 
the Test database, containing the string “Romeo”. If not, carefully read the 
documentation of your SQL tool to see how you need to enter SQL state- 
ments. For example, with some SQL tools, you need a special terminator for 
each SQL statement. 


Next, locate the JDBC driver and run a sample Java program to verify that the 
installation was successful. 
Here are the steps for testing the JDBC driver. 


1. Every JDBC driver contains some Java code that your Java programs require 
to connect to the database. From the JDBC driver documentation, find the 
class path for the driver. Here is a typical example—the class path component 


for the Apache Derby JDBC driver that is included in the Java 
Development kit. 


—— 
Ghaie eee oateees 
_ Make sure the 
i ie ware ; 


a ieee ees ate 


id 


as 


AA 
ne. 
> 


c:\jdk1.6.0\db\lib\derby.jar 

One version of the Oracle database uses a class path 
/usr/local/oracle/jdbc/classes111b.zip 

You will find this information in the documentation of your JDBC driver. 


2. If your JDBC driver is not fully compliant with the JDBC4 standard, you 
need to know the name of the driver class. For example, the Oracle database 
uses a driver 


oracle. jdbc.driver.OracleDriver 


Your JDBC driver documentation will have this information. 
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3. Find the name of the database URL that your driver expects. All database 
URLs have the format 


jdbc:subprotocol: driver-specific data 


The subprotocol is a code that identifies the driver manufacturer, such as mckoi 
or oracle. The driver-specific data encode the database name and the location 
of the database. Here are typical examples: 


jdbc: derby: InvoiceDB;create=true 
jdbc:oracle:thin:@larry.mathcs.sjsu.edu:1521:InvoiceDB 


Again, consult your JDBC driver information for details on the format of the 
database URL and how to specify the database that you use. 


4. In order to run the TestDB. java program at the end of this section, edit the file 
database.properties and supply 


e The driver class name (if required) 
¢ The database URL 

° Your database user name 

¢ Your database password 


With lightweight Java databases such as Apache Derby, you usually specify a 


blank user name and password. 


5. Compile the program as 
javac TestDB.java 
6. Run the program as 
java -classpath driver_class_path;. TestDB database.properties 
In UNIX/Linux, use a : separator in the class path: 
java -classpath driver_class_path:. TestDB database.properties 


If everything works correctly, you will get an output that lists all data in the 
Test table. If you followed the test instructions precisely, you will see one line 
of output with the name “Romeo”. 


If your program doesn’t work, there are several possible causes. 


e If you get an error message about a missing driver, then the program cannot 


load the JDBC driver. Check the class path and the driver name. 


° If you get an error message that the driver cannot connect to the database, 
then the database may not be started, or, if the database is located on 
another computer, then the database may not be reachable. Check that the 
database is working by connecting with a SQL tool. 


° If you get an error message about failed login, check the database name in 
the database URL, the user name, and the password. 


° If you get an error message about a missing Test table, make sure you create 
and populate the table as described in the database test. 
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Here is the test program. We will explain the Java instructions of this program in the 
following section. 


ch22/test/TestDB.java 


1 import java.io.File 
2 import java.sql.Connection; 
3 import java.sql.ResultSet; 
4 import java.sql.Statement; 
5 
6 ; 
7 Tests a database installation by creating and querying 
8 a sample table. Call this program as 
9 java -classpath driver_class_path;. TestDB database.properties 
10 * 
11 public class TestDB 
12 { 
13 public static void main(String[] args) throws Exception 
14 { 
15 if Cargs.length == 0) 
16 { 
17 System.out.printIn( 
18 "Usage: java -classpath driver_class_path” 
19 + File.pathSeparator 
20 + ". TestDB database.properties"); 
21 return; 
22 } 
“3 else 
24 SimpleDataSource.init(argsl0]); 
25 
26 Connection conn = SimpleDataSource.getConnection() ; 
27 try 
28 { 
29 Statement stat = conn.createStatement() ; 
30 
31 stat.execute("CREATE TABLE Test (Name CHAR(20))"); 
32 stat.execute("INSERT INTO Test VALUES ('Romeo')"); 
33 
34 ResultSet result = stat.executeQuery("SELECT * FROM Test"); 
35 result.next(); 
36 System.out.printInCresult.getString('Name")) ; 
37 
38 stat.execute("DROP TABLE Test"); 
39 } 
40 finally 
41 { 
42 conn.close(); 
43 } 
4, } 
45 } 


ch22/test/SimpleDataSource.java 


1 import java.sql.Connection; 
2 import java.sql.DriverManager; 
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import java.sql.SQLException; 
import java.io.FileInputStream; 
import java.io. IOException; 
import java.util.Properties; 


A simple data source for getting database connections. 


ay 
public class SimpleDataSource 
{ 
Initializes the data source. 
@param fileName the name of the property file that 
contains the database driver, URL, username, and password 
oe 
public static void init(String fileName) 
throws IOException, ClassNotFoundException 
{ 
Properties props = new Properties(); 
FileInputStream in = new FileInputStream(fileName) : 
props. load(in); 
String driver = props.getProperty("jdbc.driver"): 
url = props.getProperty("jdbc.url");: 
username = props.getProperty("jdbc.username”) ; 
1f Cusername == null) username = ""; 
password = props.getProperty("jdbc.password"); 
1f (password == null) password = '""; 
if (driver != null) 
Class. forName(driver) ; 
t 
/* * 
Gets a connection to the database. 
@return the database connection 
7 
public static Connection getConnection() throws SQLException 
{ 
return DriverManager.getConnection(url, username, password); 
t 
private static String url; 
private static String username; 
private static String password; 
i 


ch22/test/database.properties (for Apache Derby) 


W1 fs W RQ pt 


jdbc.url=jdbc:derby:BigJavaDB; create=true 

# With other databases, you may need to add entries such as these 
# jdbc.username=admin 

# jdbc.password=secret 

# jdbc.driver=org.apache.derby.jdbc.EmbeddedDriver 
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SELF CHECK 


5. After installing a database system, how can you test that it is properly installed? 


6. You are starting a Java database program to use the Apache Derby database and 
get the following error message: 


Exception in thread "main" java.sql.SQLException: No suitable driver found 
for jdbc:derby:BigJavaDB;create=true 


What is the most likely cause of this error? 


=e JaVd. STOO AEST AT AGNES TG 


To connect to a database, you need an object of the class Connection. 


ae Ler ee ese The following shows you how to obtain such a connection. With 
FERIA SIGE ee older versions of the JDBC standard, you first need to manually load 
ar the database driver class. Starting with JDBC4 (which is a part of Java 

6), the driver is loaded automatically. If you use Java 6 or later and a fully JOBC4 
compatible driver, you can skip the loading step. Otherwise, use the following code: 


-aJjava program. 


String driver=.. .} 

Class.forName(driver); // Load driver 

Next, you ask the DriverManager for a connection. You need to initialize the url, 
username, and password strings with the values that apply to your database. 

String url = < «. a4 

String username =. . .;3 

String password =. . .; 

Class.forName(driver); // Load driver 


Connection conn = DriverManager.getConnection(url, 
username, password) ; 


When you are done issuing your database commands, close the database connection 
by calling the close method: 


conn.close(); 


This is actually a somewhat simplistic view of connection management. Two prob- 
lems occur in practice. Larger programs (such as the bank example in Section 22.5) 
need to connect to the database from many classes. You don’t want to propagate the 
database login information to a large number of classes. Also, it is usually not feasi- 
ble to use a single connection for all database requests. In particular, as you will see 
in Chapter 24, a container for Java server pages can run many simultaneous web 
page requests from different browsers. Each page request needs its own database 
connection. But because opening a database connection is quite slow and page 
requests come so frequently, database connections need to be pooled rather than 
closed and reopened. The details can be complex, and there is currently no standard 
implementation available. 
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It is always a good idea to decouple connection management from the other data- 
base code. We supply a SimpleDataSource class for this purpose. You can find the 
implementation at the end of the preceding section. This class is a very simple tool 
for connection management. At the beginning of your program, call the static init 
method with the name of the database configuration file, for example 


SimpleDataSource.init("database. properties"); 
The configuration file is a text file that may contain the following lines: 


jdbc.driver= . 
jdbc.url= . 
jdbc.username= . 
jdbc.password= . 


The init method uses the Properties class, which is designed to make it easy to read 
such a file. 

The Properties class has a load method to read a file of key/value pairs from a 
stream: 


Properties props = new Properties(); 
FileInputStream in = new FileInputStream(fileName) ; 
props. load(in); 


The getProperty method returns the value of a given key: 
String driver = props.getProperty("jdbc.driver"); 


You don’t actually have to think about this—the init method takes care of the 
details. 
Whenever you need a connection, call 


Connection conn = SimpleDataSource.getConnection(); 
You need to close the connection by calling 
conn.close(); 


when you are done using it. 
Real-world connection managers have slightly different methods, but the basic 
principle is the same. 


QUALITY TIP 22.1 


Don’t Hardwire Database Connection Parameters into Your Program 


It is considered inelegant to hardwire the database parameters into a program. 


public class MyProg 


{ 
public static void main(String[] args) 
{ 
// Don’t do this: 
String driver = "oracle. jdbc.driver.OracleDriver": 
String url = "jdbc:oracle:thin:@larry.mathcs.sjsu.edu:1521:InvoiceDB": 


String username = "admin"; 


A Connection object can 
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String password = "secret"; 
} 
} 
If you want to change to a different database, you must locate these strings, update them, and 
recompile. 


Instead, place the strings into a separate configuration file. The SimpleDataSource. java 
file reads in a configuration file with the database connection parameters. To connect to a dit- 
ferent database, you simply supply a different configuration file name on the command line. 


Once you have a connection, you can use it to create Statement objects. You need 
Statement objects to execute SQL statements. 


Statement stat = conn.createStatement() ; 


create Statement objects’ The execute method of the Statement class executes a SQL statement. 
_ that are used to execute For example, 


“SQL commands, 


The result of a SQL query 
turned ina ResultSet 


‘is re 


Poblect 7a. 


stat.execute("CREATE TABLE Test (Name CHAR(20))"); 

stat.executeC("INSERT INTO Test VALUES ('Romeo')"); 
To issue a query, use the executeQuery method of the Statement class. 
The query result is returned as a ResultSet object. For example, 
Sens String query = "SELECT * FROM Test’; 

= ResultSet result = stat.executeQuery (query) ; 
You will see in the next section how to use the Resu1tSet object to analyze the result 
of the query. 

For UPDATE statements, you can use the executeUpdate method. It returns the 
number of rows affected by the statement: 


String command = "UPDATE LineItem" 

+ " SET Quantity = Quantity + 1" 

+ " WHERE Invoice Number = '11731'"; 
int count = stat.executeUpdate(command) ; 


If your statement has variable parts, then you should use a PreparedStatement instead. 


String query = "SELECT * WHERE Account_Number = ?"; 

PreparedStatement stat = conn.prepareStatement (query) ; 
The ? symbols in the query string denote variables that you fill in when you make 
an actual query. You call a set method for that purpose, for example 


Sstat.setString(1, accountNumber) ; 


The first parameter of the set methods denotes the variable position: 1 is the first ?, 2 
the second, and so on. There are also methods setInt and setDoub1e for setting numer- 
ical variables. After you set all variables, you call executeQuery or executeUpdate. 
Finally, you can use the generic execute method to execute arbitrary SQL state- 
ments. It returns a boolean value to indicate whether the SQL command yields a 
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result set. If so, you can obtain it with the getResultSet method. Otherwise, you 
can get the update count with the getUpdateCount method. 
String command =... .; 


boolean hasResultSet = stat.execute (command) ; 
if ChasResultSet) 


if 
ResultSet result = stat.getResultSet() ; 
ty 
else 
{ 
int count = stat.getUpdateCount(); 
, 


You can reuse a Statement or PreparedStatement object to execute as many SQL 
commands as you like. However, for each statement, you should only have one 
active ResultSet. If your program needs to look at several result sets at the same 
time, then you need to create multiple Statement objects. 

When you are done using a ResultSet, you should close it before issuing a new 
query on the same statement. 


result.close(); 


When you are done with a Statement object, you should close it. That automatically 
closes the associated result set. 


Stat.close(); 


When you close a connection, it automatically closes all statements and result sets. 


COMMON ERROR 22.2 


Delimiters in Manually Constructed Queries 


Suppose you need to issue the following query with different names. 
SELECT * FROM Customer WHERE Name = customerName 
Many students try to construct a SELECT statement manually, like this: 


String customerName =... ; 
String query 

= "SELECT * FROM Customer WHERE Name = '" + customerName + "'": 
ResultSet result = stat.executeQuery (query) ; 


However, this code will fail if the name contains single quotes, such as "Sam's Smal] Appli- 
ances". The query string has a syntax error: a mismatched quote. 
The remedy is to use a PreparedStatement instead: 


String query = "SELECT * FROM Customer WHERE Name = ?"; 
PreparedStatement stat = conn.prepareStatement (query) ; 
stat.setString(1, aName); 

ResultSet result = stat.executeQuery (query) ; 
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A ResultSet lets you fetch the query result, one row at a time. You iterate through the 
rows, and for each row, you can inspect the column values. Like the collection itera- 
tors that you saw in Chapter 15, the ResultSet class has a next method to visit the 
next row. However, the behavior of the next method is somewhat different. The next 
method does not return any data but a boolean value that indicates whether more data 
are available. Moreover, when you first get a result set from the executeQuery method, 
no row data are available. You need to call next to move to the first row. This appears 
curious, but it makes the iteration loop simple: 


while Cresult.nextQ) 


Inspect column data from the current row 


} 


If the result set is completely empty, then the first call to result.nextQ returns 
false, and the loop is never entered. Otherwise, the first call to result.nextQ 
fetches the data for the first row from the database. As you can see, the loop ends 
when the next method returns false, which indicates that all rows have been 
fetched. 

Once the result set object has fetched a particular row, you can inspect its col- 
umns. Various get methods return the column value formatted as a number, string, 
date, and so on. In fact, for each data type, there are two get methods. One of them 
has an integer parameter that indicates the column position. The other has a string 
parameter for the column name. For example, you can fetch the product code as 


String productCode = result.getString(1) ; 
or 


String productCode = result.getString("Product_Code") ; 


Note that the integer index starts at one, not at zero; that is, getString(1) inspects 

the first column. Database column indexes are different from array subscripts. 
Accessing a column by an integer index is marginally faster and perfectly accept- 

able if you explicitly named the desired columns in the SELECT statement, such as 


SELECT Invoice_Number FROM Invoice WHERE Payment = 0 


However, if you make a SELECT * query, it is a good idea to use a column name 
instead of a column index. It makes your code easier to read, and you don’t have to 
update the code when the column layout changes. 

In the preceding example, you saw the getString method in action. To fetch a 
number, use the getInt and getDouble methods instead, for example 


int quantity = result.getIntC"Quantity") ; 
double unitPrice = result.getDoubleC"Price"); 
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PRODUCTIVITY HINT 22.4 
Let the Database Do the Work 


You now know how to issue a SQL query from a Java program and iterate through the result 
set. A common error that students make is to iterate through one table at a time to find a 
result. For example, suppose you want to find all invoices that contain car vacuums. You 
could use the following plan: 


1. Issue the query SELECT * FROM Product and iterate through the result set to find the 
product code for a car vacuum. 


2. Issue the query SELECT * FROM LineItem and iterate through the result set to find the 
line items with that product code. 


However, that plan 1s extremely inefficient. Such a program does in very slow motion what a 
database has been designed to do quickly. 

Instead, you should let the database do all the work. Give the complete query to the 
database: 


SELECT LineItem. Invoice Number 
FROM Product, LineItem 
WHERE Product.Description = 'Car vacuum' 
AND Product.Product_Code = LineItem.Product_Code 


Then iterate through the result set to read off all invoice numbers. 
Beginners are often afraid of issuing complex SQL queries. However, you are throwing 
away a major benefit of a relational database if you don’t take advantage of SQL. 


= Result Set Meta Data 


When you have a result set from an unknown table, you may want to 
know the names of the columns. You can use the ResultSetMetaData 
class to find out about properties of a result set. Start by requesting 
the meta data object from the result set: 


ResultSetMetaData metaData = result.getMetaData(); 


Then you can get the number of columns with the getColumnCount method. The 
getColumnLabel method gives you the column name for each column. Finally, the 
getColumnDisplaySize method returns the column width, which is useful if you 
want to print table rows and have the columns line up. Note that the indexes for 
these methods start with 1. For example, 


for (int i = 1; i <= metaData.getColumnCount(); i++) 
if 
String columnName = metaData.getColumnLabel (i); 
Int columnSize = metaData.getColumnDisplaySize(i); 
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ExecSQL.java is a useful program that puts these concepts to work. The program 
reads a file containing SQL statements and executes them all. When a statement has 
a result set, the result set is printed, using the result set meta data to determine the 
column count and column labels. 

For example, suppose you have the following file: 


ch22/exec/Product.sql 


1 CREATE TABLE Product 

Zz (Product_Code CHAR(10), Description CHAR(40), Price DECIMAL(10, 2)) 
3 INSERT INTO Product VALUES ('116-064', 'Toaster', 24.95) 

4 INSERT INTO Product VALUES ('257-535', ‘Hair dryer', 29.95) 

5 INSERT INTO Product VALUES ('643-119', 'Car vacuum', 19.95) 

6 SELECT * FROM Product 


Run the Exec.SQL program as 
java -classpath derby.sql;. ExecSQL database.properties Product.sq] 


The program executes the statements in the Product.sq1 file and prints out the 
result of the SELECT query. 
You can also use the Exec.SQL program as an interactive testing tool. Run 


java -classpath derby.sql;. ExecSQL database.properties 


Then type in SQL commands at the command line. Every time you hit the Enter 
key, the command is executed. 


ch22/exec/ExecSQL.java 


1 import java.sql.Connection; 

2 import java.sql.ResultSet; 

3 import java.sql.ResultSetMetaData; 
4 import java.sql.Statement; 

5 import java.sql.SQLException; 

6 import java.io.FileReader; 

7 import java.io.IOException; 

8 import java.util.Scanner; 

9 


Y * 
11 Executes all SQL statements in a file. 
12 Call this program as 


13 java -classpath driver_class_path;. ExecSQL 

14 database.properties commands.sq| 

15 */ 

16 public class ExecSQL 

17 { 

18 public static void main (String[] args) 

19 throws SQLException, IOException, ClassNotFoundException 


20 { 
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21 if Cargs.length == 0) 

iz { 

23 System.out.printIn( 

24 "Usage: java ExecSQL propertiesFile [statementFile]"); 
25 return; 

26 i 

af 

28 SimpleDataSource.init(args[0]); 

29 

30 Scanner in; 

31 if Cargs.length > 1) 

a in = new Scanner(new FileReader(args[1])); 

33 else 

34 in = new Scanner(System.in); 

35 

36 Connection conn = SimpleDataSource.getConnection() ; 
37 try 

38 id 

39 Statement stat = conn.createStatement(); 

40 while Cin. hasNextLine()) 

4l - 

42 String line = in.nextLineQ; 

43 . boolean hasResultSet = stat.execute(line); 
44 if ChasResultSet) 
45 4, 
46 ResultSet result = stat.getResultSet(); 
47 showResultSet(result); 

48 result.close(); 

49 } 

50 } 

51 } 

52 finally 

53 i 

54 conn.close(); 

55 } 

56 } 

af 

58 os 

59 Prints a result set. 

60 @param result the result set 

61 ay | 

62 public static void showResultSet(ResultSet result) 
63 throws SQLException 

64 { 

65 ResultSetMetaData metaData = result.getMetaData(); 
66 int columnCount = metaData.getColumnCount(); 

67 

68 for Cint i = 1; 7 <= columnCount; i++) 

69 { 

70 if G > LD System.out.print(", "); 

71 System.out.print(metaData.getColumnLabel(i)); 
TZ } 

73 System.out.printInQ; 
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75 while Cresult.next()) 

76 { 

17 for Cint i = 1; 7 <= columnCount; i++) 

78 i 

79 if OC. = 4) Systemout. printc’, "); 

System.out.print(Cresult.getString(i)); 
} 

82 System.out.printinQ; 


SELF CHECK 


7. Suppose you want to test whether there are any customers in Hawaii. Issue the | 
statement 


ResultSet result = stat.executeQuery( 
"SELECT * FROM Customer WHERE State = 'HI'"); 


Which Boolean expression answers your question? 


8. Suppose you want to know how many customers are in Hawaii. What is an effi- 
cient way to get this answer? 


In this section, we will develop a complete database program. We will reimplement 
the ATM simulation of Chapter 12, storing the customer and account data in a data- 
base. Recall that in the simulation, every customer has a customer number, a PIN, 
and two bank accounts: a checking account and a savings account. We’ll store the 
information in two tables: 


BankCustomer 
Checking _ Savings _ 
ee PIN Account_ Account_ 
Number Number 


INTEGER INTEGER INTEGER INTEGER 


Account 


Account_ Number Balance 


INTEGER DECIMAL (10, 2) 
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The Bank class now needs to connect to the database whenever it is asked to find a 
customer. Here is the implementation of the method that finds a customer. The 
method makes a query 


SELECT * FROM BankCustomer WHERE Customer _Number = . 


It then checks that the PIN matches, and it constructs a Customer object. This 
method turns the row-and-column information of the database into object-oriented 
data. 


public Customer findCustomer(int customerNumber, int pin) 
throws SQLException 


{ 

Connection conn = SimpleDataSource.getConnection() ; 

try 

if 
Customer c = null; 
PreparedStatement stat = conn.prepareStatement( 

"SELECT * FROM BankCustomer WHERE Customer_Number = ?"); 
stat.setInt(1, customerNumber) ; 
ResultSet result = stat.executeQueryQ ; 
if Cresult.nextQ && pin == result.getIntC'PIN")) 
Cc = new Customer(customerNumber, 
result.getIntC'Checking_Account_Number") , 
result.getIntC"Savings_Account_Number") ) ; 

return Cc; 

; 

finally 

{ 
conn.close(); 

5 

} 


Note that the method throws a SQLException. Why don’t we catch that exception 
and return nu11 if an exception occurs? There are many potential reasons for a SQL 
exception, and the Bank class doesn’t want to hide the exception details. But the Bank 
class also doesn’t know anything about the user interface of the application, so it 
can’t display information about the exception to the user. By throwing the excep- 
tion to the caller, the information can reach the part of the program that interacts 
with the user. 

The BankAccount class in this program is quite different from the implementation 
you have seen throughout the book. Now we do not store the balance of the bank 
account in the object; instead, we look it up from the database: 


public double getBalance() 
throws SQLException 
{ 
Connection conn = SimpleDataSource.getConnection(); 
try 
{ 


double balance = 0 
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PreparedStatement stat = conn.prepareStatement ( 
"SELECT Balance FROM Account WHERE Account _Number = ?"); 
Stat.setInt(1, accountNumber) ; 
ResultSet result = stat.executeQuery() ; 
if Cresult.nextQ) 
balance = result.getDouble(1) ; 
return balance; 


} 
finally 
{ 
conn.close(); 
} 


} 
The deposit and withdraw operations immediately update the database as well: 


public void deposit(double amount) 
throws SQLException 


{ 
Connection conn = SimpleDataSource.getConnection() ; 
try 
4. 
PreparedStatement stat = conn.prepareStatement ( 
"UPDATE Account" 
+ " SET Balance = Balance + ?" 
+ " WHERE Account_Number = ?"); 
Stat.setDouble(1, amount); 
Stat.setInt(2, accountNumber) ; 
Stat.executeUpdateQ ; 
} 
finally 
1 
conn.close(); 
} 
} 


It seems somewhat inefficient to connect to the database whenever the bank balance 
is accessed, but it is much safer than storing it in an object. Suppose you have two 
instances of the ATM program running at the same time. Then it 1s possible that 
both programs modify the same bank account. If each of them copied the bank bal- 
ances from the database into objects, then the modifications made by one user 
would not be seen by the other. 

You can try out this simultaneous access yourself, simply by running two 
instances of the ATM simulation. Alternatively, you can modify the main method of 
the ATMViewer class to pop up two ATM frames. 

The source code for the modified ATM application follows. The source code for 
the ATM and ATMSimulator/ATMViewer classes is only changed minimally, by adding 
code to deal with the SQLException. The Customer class is unchanged. We do not list 
those classes. 

This example completes our chapter on Java database programming. You have 
seen how you can use SQL to query and update data in a database and how the 
JDBC library makes it easy for you to issue SQL commands in a Java program. 
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ch22/atm/Bank.java 


import java.sql.Connection; 

import java.sql.ResultSet; 

import java.sql.PreparedStatement; 
import java.sql.SQLException; 


ale ole 
awe 


A bank consisting of multiple bank accounts. 


public class Bank 


1 
2 
3 
4 
5 
6 
/ 
8 
9 
10 { 
11 
12 
13 
14 


[ee 
Finds a customer with a given number and PIN. 
@param customerNumber the customer number 
@param pin the personal identification number 
15 @return the matching customer, or nul] if none found 
16 | 
17 public Customer findCustomer(int customerNumber, int pin) 
18 throws SQLException 
19 f 
20 Connection conn = SimpleDataSource.getConnection() ; 
21 try 
22 f 
23 Customer c = null; 
24 PreparedStatement stat = conn.prepareStatement ( 
25 "SELECT * FROM BankCustomer WHERE Customer_Number = ?"); 
26 Stat.setInt(1, customerNumber) ; 
27 
28 ResultSet result = stat.executeQuery(); 
29 if Cresult.nextQ) && pin == result.getInt("PIN")) 
30 Cc = new Customer(customerNumber, 
31 result.getInt("Checking_Account_Number"), 
32 result.getInt("Savings_ Account_Number")); 
33 return c; 
34 } 
35 finally 
36 { 
37 conn.close(); 
38 } 
39 } 
40 } 


ch22/atm/BankAccount.java 


import java.sql.Connection; 

import java.sql.ResultSet; 

import java.sql.PreparedStatement; 
import java.sql.SQLException; 


A bank account has a balance that can be changed by 
deposits and withdrawals. 


te 
aw 
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10 public class BankAccount 


ll f 
12 [er 
13 Constructs a bank account with a given balance. 
14 @param anAccountNumber the account number 
15 * / 
2 public BankAccount(int anAccountNumber) 
/ { 
18 accountNumber = anAccountNumber:; 
19 } 
20 
va | [x 
22 Deposits money into a bank account. 
23 @param amount the amount to deposit 
24 * 
25 public void deposit(double amount) 
26 throws SQLException 
27 { 
28 Connection conn = SimpleDataSource.getConnection(); 
29 try 
30 { 
31 PreparedStatement stat = conn.prepareStatement( 
32 "UPDATE Account" 
33 + " SET Balance = Balance + ?" 
34 + " WHERE Account_Number = ?"); 
35 stat.setDouble(i, amount): 
36 stat.setInt(2, accountNumber); 
37 stat.executeUpdate(); 
38 } 
39 finally 
40 { 
Al conn.close(); 
42 } | 
43 } | 
a4 
A5 hi 
46 Withdraws money from a bank account. 
47 @param amount the amount to withdraw 
AS a 
49 public void withdraw(double amount) 
50 throws SQLException 
51 { 
52 Connection conn = SimpleDataSource.getConnection(); 
53 try 
54 { 
55 PreparedStatement stat = conn.prepareStatement( 
56 "UPDATE Account" 
57 + " SET Balance = Balance - ?" 
58 + " WHERE Account_Number = ?"); 
59 stat.setDouble(1, amount); 
60 stat.setInt(2, accountNumber) ; 


61 stat.executeUpdate() ; | 
| 
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63 finally 

64 { 

65 conn.close(); 

66 } 

67 } 

68 

69 we 

70 Gets the balance of a bank account. 

71 @return the account balance 

72 a A 

73 public double getBalance() 

74 throws SQLException 

75 { 

76 Connection conn = SimpleDataSource.getConnection() ; 
77 try 

78 { 

79 double balance = () 

80 PreparedStatement stat = conn.prepareStatement ( 
$1 "SELECT Balance FROM Account WHERE Account_Number = ?"); 
82 stat.setInt(1, accountNumber) ; 

83 ResultSet result = stat.executeQuery(); 
$4 if Cresult.next()) 

85 balance = result.getDouble(|); 

86 return balance; 

87 } 

88 finally 

89 { 

90 conn.close(); 

91 I; 

92 $ 

93 

94 private int accountNumber; 

95 

SELF CHECK 


9. Why doesn’t the Bank class store an array of Customer objects? 
10. Why do the BankAccount methods throw an SQLException instead of catching it? 


ADVANCED TOPIC 22.2 


Transactions 


An important part of database processing is transaction handling. A transaction is a set of 
database updates that should either succeed in its entirety or not happen at all. For example, 
consider a banking application that transfers money from one account to another. This oper- 
ation involves two steps: reducing the balance of one account and increasing the balance of 
another account. No software system is perfect, and there is always the possibility of an 
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error. The banking application, the database program, or the network connection between 
them could exhibit an error right after the first part—then the money would be withdrawn 
from the first account but never deposited to the second account. Clearly, this would be very 
bad. There are many other similar situations. For example, if you change an airline reserva- 
tion, you don’t want to give up your old seat until the new one is confirmed. 

What all these situations have in common is that there is a set of database operations that 
are grouped together to carry out the transaction. All operations in the group must be car- 
ried out together—a partial completion cannot be tolerated. In SQL, you use the COMMIT and 
ROLLBACK commands to manage transactions. For example, to transfer money from one 
account to another, you issue the commands 


UPDATE Account SET Balance = Balance - 1000 
WHERE Account_Number = '95667-2574' 
UPDATE Account SET Balance = Balance + 1000 
WHERE Account_Number = '82041-1196' 
COMMIT 


The COMMIT command makes the updates permanent. Conversely, the ROLLBACK command 
undoes all changes up to the last COMMIT. 

When you program with JDBC, by default the JDBC library automatically commits all 
database updates. That is convenient for simple programs, but it is not what you want for 
transaction processing. Thus, you should first turn the autocommit mode off: 


Connection conn = . 
conn. sakautoConideGalsels 
Statement stat = conn.createStatement() ; 


Then issue the updates that form the transaction and call the commit method of the Statement class. 


Stat. executeUpdate ( 

"UPDATE Account SET Balance = Balance - " 

+ amount + " WHERE Account_Number = " + fromAccount) ; 
Stat.executeUpdate( 

"UPDATE Account SET Balance = Balance " 


+ amount + " WHERE Account _Number = + toAccount); 
conn.commit(); 


+ 


Conversely, if you encounter an error, then call the rollback method. This typically happens 
in an exception handler: 


try 
{ 


} 
catchCSQLException exception) 


{ 


conn.rollback(); 


} 


You may wonder how a database can undo updates when a transaction is rolled back. The 
database actually stores your changes in a set of temporary tables. If you make queries 
within a transaction, the information in the temporary tables is merged with the permanent 
data for the purpose of computing the query result, giving you the illusion that the updates 
have already taken place. When you commit the transaction, the temporary data are made 
permanent. When you execute a rollback, the temporary tables are simply discarded. 
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ADVANCED TOPIC 22.3 


Object-Relational Mapping 


Database tables store rows that contain strings, numbers, and other fundamental data types, 
but not arbitrary objects. In Sections 22.1.2 and 22.1.3, you learned how to translate object 
references into database relationships. An object-relational mapper automates this process. 
The Java Enterprise Edition contains such a mapper. You add annotations to the Java classes 
that describe the relationships. The rules are simple: 


e Add @entity to every class that should be stored in the database. 
e Each entity class needs an ID that is annotated with @Id. 


e Relationships between classes are expressed with @OneToOne, @OneToMany, @ManyToOne, and 
@ManyToMany. 


Here are the annotations for the invoice classes. A customer can have many invoices, but 
each invoice has exactly one customer. This is expressed by the @ManyToOne annotation. Con- 
versely, each line item is contained in exactly one invoice, but each invoice can have many 
line items. This is expressed by the @OneToMany relationship. 


@Entity public class Invoice 


{ 
@Id private int id; 
@ManyToOne private Customer theCustomer; 
@OneToMany private List<LineItem> items; 
private double payment; 
} 
@Entity public class LineItem 
{ 
@Id private int id; 
@ManyToOne private Product theProduct; 
private int quantity 
; 
@Entity public class Product 
{ 
@Id private int id; 
private String description; 
private double price; 
} 


@Entity public class Customer 
{ 


@Id private int id; 
private String name; 
private String address; 
private String city; 
private String state; 
private String zip; 
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The object-relational mapper processes the annotations and produces a database table lay- 
out. You don’t have to worry exactly how the data are stored in the database. For example, 
to store a new invoice, simply build up the Java object and call 


entityManager.persist(invoice) ; 


Asa result of this call, the data for the invoice and line items are automatically stored in the 
various database tables. 

To read data from the database, you do not use SQL —after all, you do not know the exact 
table layout. Instead, you formulate a query in an object-oriented query language. A typical 
query looks like this: 


SELECT x FROM Invoice x WHERE x.id = 11731 


The result is a Java object of type Invoice. The references to the customer and line item 
objects have been automatically populated with the proper data from various tables. 

Object-relational mapping technology is powerful and convenient. However, if you still 
need to understand the underlying principles of relational databases in order to specify eff- 
cient mappings and queries. 


CHAPTER SUMMARY 


1. A relational database stores information in tables. Each table column has a 
name and a data type. 


2. SQL (Structured Query Language) is a command language for interacting with 
a database. 


3. Use the SOL commands CREATE TABLE and INSERT INTO to add data to a database. 


4. You should avoid rows with replicated data. Instead, distribute the data over 
multiple tables. 


5. A primary key is a column (or set of columns) whose value uniquely specifies a 
table record. 


6. A foreign key is a reference to a primary key ina linked table. 

7. Use the SQL SELECT command to query a database. 

8. A join is a query that involves multiple tables. 

9. The UPDATE and DELETE SQL commands modify the data in a database. 


10. You need a JDBC (Java Database Connectivity) driver to access a database from 
a Java program. 


11. Make sure the JDBC driver is on the class path when you launch the Java 
program. 


12. Use a Connection object to access a database from a Java program. 
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13. A Connection object can create Statement objects that are used to execute SQL 


commands. 


14. The result of a SQL query is returned in a ResultSet object. 


15. Meta data are data about an object. Result set meta data describe the properties 


of a result set. 


FURTHER READING 


1. Chris J. Date and Hugh Darwen, A Guide to the SQL Standard: A User’s Guide to the 
Standard Database Language SQL, 4th edition, Addison-Wesley, 1997. 


2. http://ww.cpsr.org/cpsr/privacy/ssn/ssn.faq.html A list of frequently asked 
questions about Social Security numbers, by Computer Professionals for Social 


Responsibility. 


3. http://ww.ftc.gov/privacy/ A web site on information privacy by the Federal Trade 


Commission. 


4, http://db.apache.org/derby/ ‘The web site for the lightweight Apache Derby 


database. 


CLASSES, OBJECTS, AND METHODS 
INTRODUCED IN THIS CHAPTER 


java.io.File 
pathSeparator 
java. lang.Class 
forName 
java.sqli.Connection 
close 
commit 
createStatement 
prepareStatement 
rollback 
setAutoCommit 
java.sql.DriverManager 
getConnection 
jJava.sql.PreparedStatement 
execute 
executeQuery 
executeUpdate 
setDouble 
setint 
setString 


java.sql.ResultSet 
close 
getDouble 
getiInt 
getMetaData 
getString 
next 
java.sql.ResultSetMetaData 
getColumnCount 
getColumnDisplaySize 
getColumnLabel 
java.sql.SQLException 
java.sql.Statement 
close 
execute 
executeQuery 
executeUpdate 
getResultSet 
getUpdateCount 
java.util.Properties 
getProperty 
load 
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REVIEW EXERCISES 


Exercise R22.1. Design a set of database tables to store people and cars. A person has 
a name, a unique driver license number, and an address. Every car has a unique 
vehicle identification number, manufacturer, type, and year. Every car has one 
owner, but one person can own multiple cars. 


Exercise R22.2. Design a set of database tables to store library books and patrons. A 
book has an ISBN (International Standard Book Number), an author, and a title. 
The library may have multiple copies of each book, each with a different book ID. 
A patron has a name, a unique ID, and an address. A book may be checked out by 
at most one patron, but one patron can check out multiple books. 


Exercise R22.3. Design a set of database tables to store sets of coins in purses. Each 
purse has an owner name and a unique ID. Each coin type has a unique name and a 
value. Each purse contains some quantity of coins of a given type. 


Exercise R22.4. Design a set of database tables to store students, classes, professors, 
and classrooms. Each student takes zero or more classes. Each class has one profes- 
sor, but a professor can teach multiple classes. Each class has one classroom. 


Exercise R22.5. Give SQL commands to create a Book table, with columns for the 
ISBN, author, and title, and to insert all textbooks that you are using this semester. 


Exercise R22.6. Give SQL commands to create a Car table, with columns for the 
vehicle identification number, manufacturer, model, and year of each car, and to 
insert all cars that your family members own. 


Exercise R22.7. Give a SQL query that lists all products in the invoice database of 
Section 22.2. 


Exercise R22.8. Give a SQL query that lists all customers in California. 
Exercise R22.9. Give a SQL query that lists all customers in California or Nevada. 
Exercise R22.10. Give a SQL query that lists all customers not in Hawaii. 


Exercise R22.11. Give a SQL query that lists all customers who have an unpaid 
invoice. 


Exercise R22.12. Give a SQL query that lists all products that have been purchased 
by a customer in California. 


Exercise R22.13. Give a SQL query that lists all line items that are part of invoice 
number 11731. 


Exercise R22.14. Give a SQL query that computes the sum of all quantities that are 
part of invoice number 11731. 


Exercise R22.15. Give a SQL query that computes the total cost of all line items in 
invoice number 11731. 


Exercise R22.16. Give a SQL update statement that raises all prices by 10%. 
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Exercise R22.17. Give aSQL statement that deletes all customers in California. 


Exercise R22.18. Pick a database system (such as DB2, Oracle, Postgres, or SQL 
Server) and determine from the web documentation: 


e What JDBC driver do you need? Is it automatically discovered? 
e What is the database URL? 


Exercise R22.19. What is the difference between a Connection and a Statement? 


Exercise R22.20. Of the SQL commands introduced in this chapter, which yield 
result sets, which yield an update count, and which yield neither? 


Exercise R22.21. How is a ResultSet different from an Iterator? 


Additional review exercises are available in WileyPLUS. 


PROGRAMMING EXERCISES | 


Exercise P22.1. Write a Java program that creates a Coin table with coin names and 
values; inserts coin types penny, nickel, dime, quarter, half dollar, and dollar; and 
prints out the sum of the coin values. Use CREATE TABLE, INSERT, and SELECT SUM 
SQL commands. 


Exercise P22.2. Write a Java program that creates a Car table with car manufacturers, 
models, model years, and fuel efficiency ratings. Insert several cars. Print out the 
average fuel efficiency. Use CREATE TABLE, INSERT, and SELECT AVG SQL commands. 


Exercise P22.3. Reimplement the bank data program from Section 19.3 using a data- 
base table for the bank accounts. . 


Exercise P22.4. Improve the ExecSQL program and make the columns of the output 
line up. Hint: Use the getColumnDisplaySize method of the ResultSetMetaData class. 


Exercise P22.5. Write a Java program that uses the database tables from the invoice 
database in Section 22.2. Prompt the user for an invoice number and print out the 
invoice, formatted as in Chapter 12. 


Exercise P22.6. Write a Java program that uses the database tables from the invoice 
database in Section 22.2. Produce a report that lists all customers, their invoices, the 
amounts paid, and the unpaid balances. 


Exercise P22.7. Write a Java program that uses a library database of books and patron 
data, as described in Exercise R22.2. Patrons should be able to check out and return 
books. Supply commands to print the books that a patron has checked out and to 
find who has checked out a particular book. Create and populate Patron and Book 
tables before running the program. 
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Exercise P22.8. Write a Java program that creates a grade book for a class. Create and 
populate Student and Grade tables before running the program. The program 
should be able to display all grades for a given student. It should allow the instruc- 
tor to add a new grade (such as “Homework 4: 100”) or modify an existing grade. 


Exercise P22.9. Write a program that assigns seats on an airplane as described in 
Exercise P12.8. Keep the seating information in a database. 


Exercise P22.10. Write a program that keeps an appointment calendar in a database. 
An appointment includes a description, a date, the starting time, and the ending 
time; for example, 

Dentist 2007/10/1 17:30 18:30 

CS1 class 2007/10/2 08:30 10:00 
Supply a user interface to add appointments, remove canceled appointments, and 
print out a list of appointments for a particular day. 


Exercise P22.11. Modify the ATM simulation program of Section 22.5 so that the 
program pops up two ATM frames. Verify that the database can be accessed simul- 
taneously by two users. 


Additional programming exercises are available in WileyPLUS. 


PROGRAMMING PROJECTS 


Project 22.1. Implement a message board application that stores users and messages 
in a database. Users can post messages, reply to messages, and view posted mes- 
sages. Provide views that list the messages by topic, by user, and by posting date. 
Allow the user to view all replies to a given message. 


Project 22.2. Implement a group calendar application that stores users, groups, and 
event dates in a database. Users can join groups. Meetings and other events can be 
scheduled, and individuals and groups can be added as participants. Users can 
accept or reject invitations to events. Provide views that show all events of a user in 
a given time interval, and all users for an event, showing whether they have accepted 
or rejected the invitation. 
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ANSWERS TO SELF-CHECK QUESTIONS 


1 


10. 


The telephone number for each customer may not be unique—the same num- 
ber might be shared by roommates. Even if the number were unique, however, 
it can change when a customer moves. In that situation, both the primary and 
all foreign keys would need to be updated. Therefore, a customer ID is a better 
choice. 


. Customer 3176 ordered ten toasters. 


SELECT Name FROM Customer WHERE State <> 'AK' AND State <> 'HI' 


SELECT Invoice.Invoice_Number FROM Invoice, Customer 

WHERE Invoice.Customer_Number = Customer.Customer_Number 

AND Customer.State = 'HI' 
Connect to the database with a program that lets you execute SQL instructions. 
‘Try creating a small database table, adding a record, and selecting all records. 
Then drop the table again. 


You didn’t set the class path correctly. The JAR file containing the JDBC driver 
must be on the class path. 


result.next(). If there is at least one result, then next returns true. 


ResultSet result = stat.executeQuery ( 

"SELECT COUNT(*) FROM Customer WHERE State = 'HI'"); 
result.nextQ; 
int count = result.getInt(1); 
Note that the following alternative is significantly slower if there are many such 
customers. 
ResultSet result = stat.executeQuery ( 

"SELECT * FROM Customer WHERE State = 'HI'"); 
while Cresult.nextQ)) count++: // Inefficient 
The customer data are stored in the database. The Bank class is now merely a 
conduit to the data. 


The methods are not equipped to handle the exception. What could they do? 
Print an error report? To the console or a GUI window? In which language? 


CHAPTER GOALS 


Understanding XML elements and attributes 
Understanding the concept of an XML parser 
Being able to read and write XML documents 


Being able to design Document Type Definitions for 
XML documents 


In this chapter, you will learn about the Extensible Markup Language (XML), a 
mechanism for encoding data that is independent of any programming language. 
XML allows you to encode complex data in a form that the recipient can easily 
parse. XML is becoming very popular for data exchange. It is simple enough that a 
wide variety of programs can easily generate XML data. XML data has a nested 
structure, so you can use it to describe hierarchical data sets—for example, an 
invoice that contains many items, each of which consists of a product and a 
quantity. Because the XML format is standardized, libraries for parsing the data are 


widely available and—as you will see in this chapter—easy to use for a programmer. 
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It is particularly easy to read and write XML documents in Java. In fact, it is 
generally easier to use XML than it is to use an “ad hoc” file format. Thus, using 


XML makes your programs easier to write and more professional. 


CuHapter Contents 
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23.3 Creating XML Documents 981 
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sacs allows ) yout to encode | 
complex data, _ look at a typical example. We will encode product descriptions, so 
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23.1.1 Advantages of XML 


To understand the advantages of using XML for encoding data, let’s 


independent from any 2 that they can be transferred to another computer. Your first attempt 


programming language, | in | Mgnt be a naive encoding like this: 
a form that the neopets 


| Toaster 
can easily parse. So 29.95 


In contrast, here is an XML encoding of the same data: 


<product> 
<description>Toaster</description> 
<price>29.95</price> 

</product> 


The advantage of the XML version is clear: You can look at the data 
and understand what they mean. Of course, this is a benefit for the 
programmer, not for a computer program. A computer program has 
no understanding of what a “price” is. As a programmer, you still need 
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to write code to extract the price as the contents of the price element. Nevertheless, 
the fact that an XML document is comprehensible by humans is a huge advantage 
for program development. 

A second advantage of the XML version is that it 1s resilient to 
change. Suppose the product data change, and an additional data item 
is introduced, to denote the manufacturer. In the naive format, the 
manufacturer might be added after the price, like this: 


are resilient to change. 


Toaster 
29.95 
General Appliances 


A program that can process the old format might get confused when reading a 
sequence of products in the new format. The program would think that the price is 
followed by the name of the next product. Thus, the program needs to be updated 
to work with both the old and new data formats. As data get more complex, pro- 
gramming for multiple versions of a data format can be difficult and time- 
| consuming. 
When using XML, on the other hand, it is easy to add new elements: 


<product> 
<description>Toaster</description> 
<price>29.95</price> 
<manufacturer>General Appliances</manufacturer> 
</product> 


Now a program that processes the new data can still extract the old information in 
the same way—as the contents of the description and price elements. The program 
need not be updated, and it can tolerate different versions of the data format. 


we will discuss in this section. 

Let us start with the similarities. The XML tag pairs, such as <price> and </price> 
look just like HTML tag pairs, for example <li> and </li>. Both in XML and in 
HTML, tags are enclosed in angle brackets < >, and a start-tag is paired with an end- 
tag that starts with a slash / character. 

However, web browsers are quite permissive about HTML. For example, you 
can omit an end-tag </1i> and the browser will try to figure out what you mean. In 
XML, this is not permissible. When writing XML, pay attention to the following 
rules: 


| © In XML, you must pay attention to the letter case of the tags; for example, <li> 
| and <LI> are different tags that bear no relation to each other. 


e Every start-tag must have a matching end-tag. You cannot omit tags, such as </1i>. 
However, if a tag has no end-tag, it must end in />, for example 


<img src="hamster.jpeg'/> 
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When the parser sees the />, it knows not to look for a matching end-tag. 

¢ Finally, attribute values must be enclosed in quotes. For example, 

<img src="hamster.jpeg" width=400 height=300/> 

is not acceptable. You must use 

<img src="hamster.jpeg" width="400" height="300"/> 
Moreover, there is an important conceptual difference between HTML and XML. 
HTML has one specific purpose: to describe web documents. In contrast, XML is 
an extensible syntax that can be used to specify many different kinds of data. For 
example, the VRML language uses the XML syntax to describe virtual reality scenes. 
The MathML language uses the XML syntax to describe mathematical formulas. 
You can use the XML syntax to describe your own data, such as product records or 
invoices. 

Most people who first see XML wonder how an XML document 
looks inside a browser. However, that is not generally a useful ques- 
tion to ask. Most data that are encoded in XML have nothing to do 
with browsers. For example, it would probably not be exciting to dis- 
play an XML document with nothing but product records (such as the ones in the 
previous section) in a browser. Instead, you will learn in this chapter how to write 
programs that analyze XML data. XML does not tell you how to display data; it is 


merely a convenient format for representing data. 
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Word Processing and Typesetting Systems 


You have almost certainly used a word processor for writing letters or reports. A word pro- 
cessor is a program to write and edit documents made up of text and images. The text can 
contain characters in various fonts. It can be arranged in paragraphs, tables, and footnotes. 
Paragraphs can be formatted in various ways, such as ragged right (that is, the left ends of the 
lines of text are aligned under each other, but the right ends aren’t), centered, and fully justi- 
fied (that 1s, both the left and right ends of the lines are aligned). What is characteristic of 
modern word processors is their “what you see is what you get” operation. You enter text 
and commands, using the keyboard and the mouse. The computer screen instantly shows 
what the printed document will look like (see Figure 1). 

However, there are disadvantages to the “what you see is what you get” (WYSIWYG, 
pronounced wis-ee-wig) nature of a word processor. You may labor to arrange various 
related images and tables on the same page. Later, you find that you need to add a couple of 
paragraphs on the preceding page. Now half of the material moves to the next page, and you 
have do the arranging all over again. It would have been more useful if you could have told 
the word processor your intention, namely: “Always keep these images and tables together 
on the same page”. In general, “what you see is what you get” programs are very good in let- 
ting you arrange material, but they don’t know why you arranged the material in a certain 
way. Thus, they can’t keep the arrangement when your document changes. Some people call 
these programs “what you see is all you’ve got”. 

More fundamentally, “what you see is what you get” programs break down when you need 
to publish the same material in multiple ways. You may want to format product information 
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Figure 1 A “What You See Is What You Get” Word Processor 


as a product parts list and an advertising brochure. Or you may want to publish the informa- 
tion in printed form, on the Web, and in spoken form for telephone retrieval. Now you no 
longer want to “get” a single result, so it isn’t as helpful to see what you get. Instead, it 
becomes much more important to visualize the structure of the information. 

A program for editing structured text needs to capture three pieces of information: 


e The text itself 


e The structural element (paragraph, bulleted list, heading, and so on) to which each part of 
the text belongs 


e The rules for formatting the structural elements 


To make it easy to interchange structured documents between computer systems, the struc- 
tural information is often encoded in markup tags. For example, XML and HTML use tags 
that are enclosed in angle brackets, such as the familiar <p>, <u1>, and <h1> tags. 

In the 1970s, when publishers began to move away from traditional manual typesetting 
to computer-based typesetting, the result at first was inferior quality, particularly for mathe- 
matical formulas. Arranging the symbols in complex formulas in a way that makes mathe- 
matical sense is an art that requires practice and good judgment, and the first typesetting 
programs were definitely not up to the job. Frustrated by this situation, the famous com- 
puter scientist Donald Knuth of Stanford University decided to do something about it and 
invented a typesetting program that he called TpX (pronounced “tek” because the “X” 1s a 
capital Greek chi). Input to that program consists of text with markup tags that start with a 
backslash; curly braces {} for grouping; and other special markup symbols, such as _ and 4 to 
indicate subscript and superscript. For example, to specify a summation, you type 


\sum_{i=1}An 7A2 
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The TX program typesets the summation as shown in Figure 2. Note that the expression is 
formatted one way when it occurs inside text and another way when it appears as part of a 
displayed formula. 

A markup tag such as <h1> in HTML or \sum in T¢X is mainly beneficial for exchanging 
documents among different computer systems. Only the most hardened HTML or TpX 
authors produce the markup by hand. For HTML in particular, many programs are available 
that display the structure of an HTML document and allow authors to edit both text and 
structure in a convenient way that combines the benefits of visual feedback and structure 
editing. 


A sum inside text: YS {2 


The same sum as a displayed formula: 
n 
7%, 
i=1 


Figure 2 A Formula Typeset in the TeX Typesetting System 


23.1.3. The Structure of an XML Document. 


An XML document starts «0 this section, you will see the rules for properly formatted XML. In 
out withanXML XML, text and tags are combined into a document. The XML stan- 
declaration and contains | dard recommends that every XML document start with a declaration 


<?xml version="1.0"?> 


Next, the XML document contains the actual data. The data are con- 
tained in a root element. For example, 


<?xml version="1.0"?> 
<invoice> 

more data 
</invoice> 


The root element is an example of an XML element. An element has one of two 
forms: 


<elementName> content </elementName> 
or 


<elementName/> 


In the first case, the element has content—elements, text, or a mixture of both. A 


good example is a paragraph in an HTML document: 


<p>Use XML for <strong>robust</strong> data formats.</p> 
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The p element contains 


1. The text: “Use XML for ” 


2. A strong child element 


3. More text: “ data formats.” 


For XML files that contain documents in the traditional sense of the 
term, the mixture of text and elements is useful. The XML specifica- 
tion calls this type of content mixed content. But for files that 
describe data sets—such as our product data—it is better to stick with 
elements that contain either other elements or text. Content that con- 
sists only of elements is called element content. 

An element can have attributes. For example, the a element of HTML has an href 
attribute that specifies the URL of a hyperlink: 


<a href="http://java.sun.com"> . . . </a> 


An attribute has a name (such as href) and a value. In XML, the value 
must be enclosed in single or double quotes. 
An element can have multiple attributes, for example 


<img src="hamster. jpeg" width="400" height="300"/> 


And, as you have already seen, an element can have both attributes 


and content. 


<a href="http://java.sun.com">Sun's Java web site</a> 


Programmers often wonder whether it is better to use attributes or child elements. 
For example, should a product be described as 


<product description="Toaster" price="29.95"/> 


OL 


<product> 
<description>Toaster</description> 
<price>29.95</price> 

</product> 


The former is shorter. However, it violates the spirit of attributes. Attributes are 
intended to provide information about the element content. For example, the price 
element might have an attribute currency that helps interpret the element content. 
The content 29.95 has a different interpretation in the element 


<price currency="USD">29.95</price> 
than it does in the element 
<price currency="EUR">29.95</price> 


You have now seen the components of an XML document that are needed to use 
XML for encoding data. There are other XML constructs for more specialized situ- 
ations—see [1] for more information. In the next section, you will see how to use 
Java to parse XML documents. 
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SELF CHECK 


1. Write XML code with a student element and child elements name and id that 
describe you. 


2. What does your browser do when you load an XML file, such as the items. xm1 
file that is contained in the companion code for this book? 


3. Why does HTML use the src attribute to specify the source of an image instead 
of <img>hamster. jpeg</img>? 


How To 23.1 


Designing an XML Document Format 


This How To walks you through the process of designing an XML document format. You 
will see in Section 23.4 how to formally describe the format with a document type definition. 
Right now, we focus on an informal definition of the document content. The “output” of 
this activity is a sample document. 


Step 1 Gather the data that you must include in the XML document. 


Write them on a sheet of paper. If at all possible, work from some real-life examples. For 
example, suppose you need to design an XML document for an invoice. A typical invoice 
has 


e An invoice number 

e A shipping address 

e A billing address 

e A list of items ordered 

If possible, gather some actual invoices. Decide which features of the actual invoices you 
need to include in your XML document. 


Step 2 Analyze which data elements need to be refined. 


Continue refinement until you reach data values that can be described by single strings or 
numbers. Make a note of all data items that you discovered during the refinement process. 
When done, you should have a list of data elements, some of which can be broken down fur- 
ther and some of which are simple enough to be described by a single string or number. 

For example, the “shipping address” actually contains the customer name, street, city, 
state, and ZIP code. 

The “list of items ordered” contains items. Each item contains a product and the quantity 
ordered. Each product contains the product name and price. 

Thus, our list now contains 


° Address 
¢ Name 

° Street 

* City 

e State 
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e ZIP code 

e List of items ordered 
e Item 

© Product 

e Description 

e Price 

¢ Quantity 


Keep breaking the data items down until each of them can be described by a single string or 
number. For example, an address cannot be described by a single string, but a city can be 
described by a single string. 


Step 3. Come up with a suitable element name that describes the entire XML document. 


This element becomes the root element. For example, the invoice data would be contained in 
an element named invoice. 


Step 4 Come up with suitable element names for the top-level decomposition that you 
found in Step 1. 


These become the children of the root element. For example, the invoice element has 


children 
® address 


® items 


Step 5 Repeat this process to give names to the other elements that you discovered in 
Step 2. 


As you do this, make a comprehensive example that shows all elements at work. For the 
invoice problem, here is an example. 


<invoice> 
<address> 
<name>ACME Computer Supplies Inc.</name> 
<street>1195 W. Fairfield Rd.</street> 
<city>Sunnyvale</city> 
<state>CA</state> 
<zip>94085</zip> 
</address> 
<items> 
<item> 
<product> 
<description>Ink Jet Refill Kit</description> 
<price>29.95</price> 
</product> 
<quantity>8&</quantity> 
</item> 
<item> 
<product> 
<description>4-port Mini Hub</description> 
<price>19.95</price> 
</product> 
<quantity>4</quantity> 
</item> 
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</items> 
</invoice> 


Step 6 Check that the document doesn’t have mixed content. 


That is, make sure each element has as its children either additional elements or text, but not 
both. If necessary, add more child elements to wrap any text. 
For example, suppose the product element looked like this: 


<product> 
<description>Ink Jet Refill Kit</description> 
29.95 

</product> 


Perhaps someone thought it was “obvious” that the last entry was the price. However, fol- 
lowing Quality Tip 23.2, it is best to wrap the price inside a price element, like this: 


<product> 
<description>Ink Jet Refill Kit</description> 
<price>29.95</price> 

</product> 


QUALITY TiP 23.1 


Prefer XML Elements over Attributes 


Attributes are shorter than elements. For example, 
<product description="Toaster" price="29.95"/> 
seems simpler than 


<product> 
<description>Toaster</description> 
<price>29.95</price> 

</product> 


There is the temptation to use attributes because they are “easier to type”. But of course, you 
don’t type XML documents, except for testing purposes. In real-world situations, XML 
documents are generated by programs. 

Attributes are less flexible than elements. Suppose we want to add a currency indication 
to the value. With elements, that’s easy to do: 


<price currency="USD">29.95</price> 
or even 


<price> 
<currency>USD</currency> 
<amount>29.95</amount> 
</price> 


With attributes, you are stuck—you can’t refine the structure. Of course, you could use 
<product description="Toaster" price="USD 29.95"/> 


But then your program has to parse the string USD 29.95 and manually take it apart. That’s 
just the kind of tedious and error-prone coding that XML is designed to avoid. 
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In HTML, there is a simple rule when using attributes. All strings that are not part of the 
displayed text are attributes. For example, consider a link. 


<a href="http://java.sun.com">The Java web page</a> 


The text inside the a element, The Java web page, is part of what the user sees on the web 
page, but the href attribute value http: //java.sun.com is not displayed on the page. 

Of course, HTML is a little different from the XML documents that you construct to 
describe data, such as product lists, but the same basic rule applies. Anything that’s a part of 
your data should not be an attribute. An attribute is appropriate only if it tells something 
about the data but isn’t a part of the data itself. If you find yourself engaged in metaphysical 
discussions to determine whether an item is part of the data or tells something about the 
data, make the item an element, not an attribute. 


QUALITY TIP 23.2 
Avoid Children with Mixed Elements and Text 


The children of an element can be 


1. Elements 
2. Text 
3. A mixture of both 


In HTML, it is common to mix elements and text, for example 
<p>Use XML for <strong>robust</strong> data formats.</p> 


But when describing data sets, you should not mix elements and text. For example, you 
should not do the following: 
<price> 
<currency>USD</currency> 


29.95 
</price> 


Instead, the children of an element should be either text 
<price>29.95</price> 
or elements 


<price> 
<currency>USD</currency> 
<amount>29.95</amount> 
</price> 


There is an important reason for this design rule. As you will see later in this chapter, you 
can specify much stricter rules for elements that have only child elements than for elements 
whose children can contain text. 
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A parser is a program that — 


reads a document, checks 

whether it is syntactically | 
correct, and takes some 
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A streaming parser reports 
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To read and analyze the contents of an XML document, you need an 
XML parser. A parser is a program that reads a document, checks 
whether it is syntactically correct, and takes some action as it pro- 
cesses the document. 

Two kinds of XML parsers are in common use. Streaming parsers 
read the XML input one token at a time and report what they 
encounter: a start tag, text, an end tag, and so on. In contrast, a tree- 
based parser builds a tree that represents the parsed document. Once 
the parser is done, you can analyze the tree. 

Streaming parsers are more efficient for handling large XML docu- 
ments whose tree structure would require large amounts of memory. 
Tree-based parsers, however, are easier to use for most applications — 
the parse tree gives you a complete overview of the data, whereas a 
streaming parser gives you the information in bits and pieces. 


In this section, you will learn how to use a tree-based parser that produces a tree 
structure according to the DOM (Document Object Model) standard. The DOM 
standard defines interfaces and methods to analyze and modify the tree structure 
that represents an XML document. 

In order to parse an XML document into a DOM tree, you need a Document- 
Builder. To get a DocumentBuilder object, first call the static newInstance method of 
the DocumentBui lderFactory class, then call the newDocumentBuilder method on the 
factory object. 


DocumentBuilderFactory factory = DocumentBui lderFactory.newInstance(); 
DocumentBuilder builder = factory.newDocumentBui Ider(); 


A DocumentBuilder can 
read an XML document _ 

froma file, URL, or input 
stream. The result is a 

Document object, which 
containsatree. 


Once you have a DocumentBuilder, you can read a document. To read 
a document from a file, first construct a File object from the file 
name, then call the parse method of the DocumentBuilder class. 

String fileName =... .; 

File f = new File(fileName); 

Document doc = builder.parse(f); 


If the document is located on the Internet, use an URL: 


String urlName =... .; 
URL u = new URLCurlName) ; 
Document doc = builder.parse(u); 


You can also read a document from an arbitrary input stream: 


InputStream in=.. .; 
Document doc = builder.parse(Cin); 


Once you have created a new document or read a document from a file, you can 
inspect and modify it. 
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<?xml version= 1.0" ?> 
<items> 
<item> 
<product> 
<description>Ink Jet Refill Kit</description> 
<price>29.95</price> 
</product> 
<quantity>8</quantity> 
</item> 
<i tem> 
<product> 
<description>4-port Mini Hub</description> 
<price>19.95</price> 
</product> 
<quantity>4</quantity> 
</item> 
</items> 


Figure 3) An XML Document 


The easiest method for inspecting a document is the XPath syntax. An XPath 
describes a node or set of nodes, using a syntax that is similar to directory paths. 
For example, consider the following XPath, applied to the document in Figure 3 
and Figure 4: 


/items/item[1]/quantity 


This XPath selects the quantity of the first item, that is, the value 8. (In XPath, array 
positions start with 1. Accessing /items/item[0] would be an error.) 
Similarly, you can get the price of the second product as 


/items/item[2]/product/price 


<items> 
<item> <item> 
<product> <quantity> <product> <quantity> 
<description> <price> 8 <description> <price> 4 
a ee a 


Figure 4 The Tree View of the Document 
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Table 1 XPath Syntax Summary 


Syntax Element Purpose Example 
name Matches an element item 
/ Separates elements /items/item 
[n] Selects a value from a set /items/item[1] 
@name Matches an attribute price/@currency 
Matches anything /items/* [1] 
count Counts matches count (/items/item) 
name The name of a match name(/items/*[1]) 


To get the number of items, use the XPath expression 
count (/items/item) 


In our example, the result is 2. 
The total number of children can be obtained as 
count(/items/*) 


In our example, the result is again 2 because the items element has exactly two 
children. 


To select attributes, use an @ followed by the name of the attribute. For example, 
/items/item[2]/product/price/@currency 


would select the currency price attribute if it had one. 
Finally, if you have a document with variable or unknown structure, you can 
find out the name of a child with an expression such as the following: 


name(/items/item[1]/*[1]) 


The result is the name of the first child of the first item, or product. 

That is all you need to know about the XPath syntax to analyze simple docu- 
ments. (See Table 1 for a summary.) There are many more options in the XPath syn- 
tax that we do not cover here. If you are interested, look up the specification [2] or 
work through the online tutorial [3]. 

To evaluate an XPath expression in Java, first create an XPath object: 


XPathFactory xpfactory = XPathFactory.newInstance(); 
XPath path = xpfactory.newxPath(); 


Then call the evaluate method, like this: 
String result = path.evaluate(expression, doc) 


Flere, expression is an XPath expression and doc is the Document object that represents 
the XML document. For example, the statement 
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String result = path.evaluate("/items/item[2]/product/price", doc) 


sets result to the string "19.95". 

Now you have all the tools that you need to read and analyze an XML document. 
The example program at the end of this section puts these techniques to work. (The 
program uses the LineItem and Product classes from Chapter 12.) The class Item- 
ListParser can parse an XML document that contains a list of product descriptions. 
Its parse method takes the file name and returns an array list of LineItem objects: 


ItemListParser parser = new ItemListParser() ; 
ArrayList<Lineltem> items = parser.parse("items.xm1"); 


The ItemListParser class translates each XML element into an object of the corre- 
sponding Java class. We first get the number of items: 


int itemCount = Integer.parseInt(path. evaluate ( 
"count(/items/item)", doc)); 


For each item element, we gather the product data and construct a Product object: 


String description = path.evaluate( 
"/items/item[" + 1 + "]/product/description", doc) ; 
double price = Double.parseDouble(path. evaluate ( 
"/items/item[" + 1 + "]/product/price", doc)); 
Product pr = new Product(description, price); 


Then we construct a LineItem object in the same way, and add it to the items array 
list. Here is the complete source code. 


ch23/parser/ItemListParser.java 


lL import java.io.File; 

2 import java.io.IOException; 

3 import java.util.ArrayList; 

4 import javax.xml.parsers.DocumentBui Ider; 

5) «6import javax.xml.parsers.DocumentBui lderFactory; 
6 import javax.xml.parsers.ParserConfigurationException; 
7 import javax.xml.xpath.XPath; 

8 import javax.xml.xpath.XPathExpressionException; 
9 import javax.xml.xpath.XPathFactory; 

10 import org.w3c.dom.Document; 

11 import org.xml.sax.SAXException; 

12 


ta 

14 An XML parser for item lists. 

ae 

16 public class ItemListParser 

i ae | 

18 

19 Constructs a parser that can parse item lists. 
20 ye 

21 public ItemListParser() 

2 throws ParserConfigurationException 
23 1 

24 DocumentBuilderFactory dbfactory 

25 = DocumentBui lderFactory.newInstance() ; 


26 builder = dbfactory.newDocumentBui lder() ; 
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Zf XPathFactory xpfactory = XPathFactory.newInstance(); 
28 path = xpfactory.newxXPath(); 

29 + 

30 

31 [** 

32 Parses an XML fille containing an item list. 

33 @param fileName the name of the file 

34 @return an array list containing all items in the XML file 

35 * / 

36 public ArrayList<LineItem> parse(String fileName) 

37 throws SAXException, IOException, XPathExpressionException 
38 { 

39 File f = new File(fileName) ; 

40 Document doc = builder.parse(f); 

41 

42 ArrayList<Lineltem> items = new ArrayList<Lineltem>(); 
43 int jtemCount = Integer.parseInt (path. evaluate( 

44 “count(/items/item)", doc)): 

45 for (int i = 1; i <= itemCount; i++) 

46 { 

47 String description = path.evaluate( 

48 "/items/item[" + 7 + "]/product/description", doc); 
49 double price = Double.parseDouble(path.evaluate( 
50 "/items/item[" + 7 + "]/product/price", doc)); 
51 Product pr = new Product(description, price); 

52 int quantity = Integer.parseInt (path. evaluate( 

53 "/items/item["” + 71 4+ "J/quantity", doc));: 

54 LineItem it = new LineItem(pr, quantity); 

55 items.add(it); 

56 } 

57 return items; 

58 } 

59 

60 private DocumentBuilder builder; 

61 private XPath path; 

62 } 


ch23/parser/ItemListParserDemo.java 


1 import java.util.ArrayList; 


ye ¥ 
This program parses an XML file containing an item list. 


2 

3 

4 

5 It prints out the items that are described in the XML file. 
4) *“ 

7 

8 


public class ItemListParserDemo 


if 
9 public static void main(String[] args) throws Exception 
10 { 
ll ItemListParser parser = new ItemListParser(); 
12 ArrayList<LineItem> items = parser.parse("items.xml"); 
13 for (LineItem anItem : items) 
14 System.out.printIn(anItem. format()); 
15 
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Output 
ink Jet Refill Kit 29.95 8 239.6 
4-port Mini Hub 19.95 4 79.8 
SELF CHECK 


4. What is the result of evaluating the XPath statement /items/item[1]/product/ 
price in the XML document of Figure 4? 


5. Which XPath statement yields the name of the root element of any XML 
document? 


COMMON ERROR 23.1 


XML Elements Describe Instance Fields, Not Classes 


When you convert XML documents to Java classes, you need to determine a class for each 
element type. A common mistake is to make a separate class for each XML element. For 
example, consider a slightly different invoice description, with separate shipping and billing 
addresses: 


<invoice> 
<shipto> 
<name>ACME Computer Supplies Inc.</name> 
<street>1195 W. Fairfield Rd.</street> 
<city>Sunnyvale</city> 
<state>CA</state> 
<Zip>94085</state> 
</shipto> 
<bi11to> 
| <name>ACME Computer Supplies Inc.</name> 
<street>P.0. Box 11098</street> 
| <city>Sunnyvale</city> 
<state>CA</state> 
| <Zip>94080-1098</zip> 
</bil1lto> 
<items> 


</items> 
</invoice> 
Should you have a class Shipto to match the shipto element and another class Bil1to to 
match the billto element? That makes no sense, because both of them have the same con- 
tents: elements that describe an address. 
Instead, you should think of the XML element as the equivalent of an instance field and 
then determine an appropriate class. For example, an invoice object has instance fields 


@ billto, of type Address 
e shipto, also of type Address 
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Note that you don’t see the classes in the XML document. There is no notion of a class 
Address in the XML document describing an invoice. To make element classes explicit, you 
use an XML schema—see Advanced Topic 23.1 for more information. 


RANDOM FACT 23.2 


Grammars, Parsers, and Compilers 


Grammars are very important in many areas of computer science to describe the structure of 
computer programs or data formats. To introduce the concept of a grammar, consider this set 
of rules for a set of simple English language sentences: 


A sentence has a noun phrase followed by a verb and another noun phrase. 

A noun phrase consists of an article followed by an adjective list followed by a noun. 
An adjective list consists of an adjective or an adjective followed by an adjective list. 
Articles are “a” and “the”. 


Adjectives are “quick”, “brown”, “lazy”, and “hungry”. 


Nouns are “fox”, “dog”, and “hamster”. 


Pe SP SP 


Verbs are “jumps over” and “eats”. 


Here are two sentences that follow these rules: 


e The quick brown fox jumps over the lazy dog. 


e The hungry hamster eats a quick brown fox. 


Symbolically, these rules can be expressed by a formal grammar: 


<sentence> ::= <noun-phrase> <verb> <noun-phrase> 
<noun-phrase> ::= <article> <adjective-list> <noun> 
<adjective-list> ::= <adjective> | <adjective> <adjective-list> 
<article> ::= a | the 
<adjective> ::= quick | brown | lazy | hungry 
<noun> ::= fox | dog | hamster 
<verb> ::= jumps over | eats 
Here the symbol ::= means “can be replaced with” and | separates alternate choices. For 


example, <article> can be replaced with “a” or “the”. 

The grammar symbols, such as <noun>, happen to be enclosed in angle brackets just like 
XML tags, but they are different from tags. One purpose of a grammar is to produce strings 
that are valid according to the grammar, by starting with the start symbol (<sentence> in this 
example) and applying replacement rules until the resulting string is free from symbols. See 
the table on the facing page for an example of the replacement process. 

If you have a grammar and a string, such as “the hungry hamster eats a quick brown fox” 
or “a brown jumps over hamster quick lazy”, you can parse the sentence: that is, check 
whether the sentence is described by the grammar rules and, if it is, show how it can be 
derived from the start symbol. One way to show the derivation is to construct a parse tree 
(see Figure 5). 


23.2 8 Parsing XML Documents 


String Rule 
<sentence> : Start 
<noun-phrase> <verb> <noun-phrase> is 
<noun-phrase> eats <noun-phrase> Z: 
<article> <adjective-list> <noun> eats <noun-phrase> 2 
the <adjective-list> <noun> eats <noun-phrase> 4 
the <adjective> <noun> eats <noun-phrase> 3 
the hungry <noun> eats <noun-phrase> 5 
the hungry hamster eats <noun-phrase> 6 
the hungry hamster eats <article> <adjective-list> <noun> 2 
the hungry hamster eats a <adjective-list> <noun> + 
the hungry hamster eats a <adjective> <adjective-list> <noun> 3 
the hungry hamster eats a quick <adjective-list> <noun> 5 
the hungry hamster eats a quick <adjective> <noun> 3 
the hungry hamster eats a quick brown <noun> 5 
the hungry hamster eats a quick brown fox 6 

<sentence> 
<noun- : <noun- 
phrase> <verb> phrase> 
<article> es <noun> <article> Ses <noun> 
<adjective> <adjective> oe ee 
<adjective> 


Figure 5 A Parse Tree for a Simple Sentence 
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A parser is a program that reads strings and decides whether the input conforms to the 
| rules of a certain grammar. Some parsers—such as the DOM XML parser—build a parse tree 
| in the process or report an error message when a parse tree cannot be constructed. Other 
| parsers—such as the SAX XML parser—call user-specified methods whenever a part of the 
| input was successtully parsed. 

The most important use for parsers is inside compilers for programming languages. Just 

as our grammar can describe (some) simple English language sentences, the valid “sentences” 


cexpression 
<term> : 
em een actor 
-<integer> <expression> 
 cdigits> Sexniec ions es <term> 
~ <digit> <term> <factor> 
| <factor> <integer> 
<integer> <digits> 
<digits> <digit> icine 


<digit> 


<digit> 


Figure 6 A Parse Tree for an Expression 
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in a programming language can be described by a grammar. The actual grammar for the Java 
programming language occupies about 15 pages in The Java Language Specification [4]. To 
give a flavor of a small subset of such a grammar, here is a grammar that describes arithmetic 


expressions. 
<expression> ::= <term> | <expression> <additive-operator> <term> 
<additive-operator> ::= + | - 
<term> ::= <factor> | <term> <multiplicative-operator> <factor> 
<multiplicative-operator> ::= * | / 
<factor> ::= <integer> | ( <expression> ) 
<integer> ::= <digits> | - <digits> 
<digits> ::= <digit> | <digit> <digits> 
<digit> ::=0O |1[2|]3]4]5|6|]7]8]9 


An example of a valid expression in this grammar is 
-2 * (3 + 10) 


Figure 6 shows the parse tree for this expression. 

In a compiler, parsing the program source is the first step toward generating code that the 
target processor (the Java virtual machine in the case of Java) can execute. Writing a parser is 
a challenging and interesting task. You may at one point in your studies take a course in 
compiler construction, in which you learn how to write a parser and how to generate code 
from the parsed input. Fortunately, to use XML you don’t have to know how the parser 
does its job. You simply ask the XML parser to read the XML input and then process the 


resulting Document tree. 


In the preceding section, you saw how to read an XML file into a Document object 
and how to analyze the contents of that object. In this section, you will see how to 
do the opposite—build up a Document object and then save it as an XML file. Of 
course, you can also generate an XML file simply as a sequence of print statements. 
However, that is not a good idea—it is easy to build an illegal XML document in 
this way, as when data contain special characters such as < or &. 

Recall that you needed a DocumentBuilder object to read in an XML document. 
You also need such an object to create a new, empty document. Thus, to create a 
new document, first make a document builder factory, then a document builder, and 
finally the empty document: 


DocumentBuilderFactory factory = 

DocumentBui IderFactory.newlInstance() ; 
DocumentBuilder builder = factory.newDocumentBui lderQ; 
Document doc = builder.newDocument() ; 
// Anempty document 


Now you are ready to insert nodes into the document. You use the 
createElement method of the Document interface to create the ele- 
ments that you need. 


‘The Document interface 

has methods to create ss 
ext nodes. | 
aiicensuncacserte ss Element priceElement = doc.createElement("price"); 
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You set element attributes with the setAttribute method. For example, 
priceElement.setAttributeC"currency", "USD"); 

You have to work a bit harder for inserting text. First create a text node: 
Text textNode = doc.createTextNode("29.95"); 

Then add the text node to the element: 
priceElement.appendChi ld(textNode) ; 


Figure 7 shows the DOM interfaces for XML document nodes. To construct the 
tree structure of a document, it is a good idea to use a set of helper methods. We 
start out with a helper method that creates an element with text: 


private Element createTextElement(String name, String text) 
{ 

Text t = doc.createlextNode(text) ; 

Element e = doc.createElement(Cname) ; 

e.appendChi ld(t); 

return e:; 


} 
Using this helper method, we can construct a price element like this: 
Element priceElement = createTextElementC"price", "29.95"); 
Next, we write a helper method to create a product element from a Product object: 


private Element createProduct(Product p) 


{ 
Element e = doc.createElementC"product") ; 
e.appendChi ld(createTextElementC"description", p.getDescription(d))); 
e.appendChi Id(createTextElementC"price", "" + p.getPrice())); 
return e; 
$ 


This helper method is called from the createItem helper method: 


private Element createItem(LineItem anItem) 


1 
Element e = doc.createElementC"item"); 
e.appendChi Id(CcreateProduct(CanItem.getProduct()); 
e.appendChi Id(CcreateTextElement ( 

"quantity", "" + anItem.getQuantityQ)); 

return e; 

} 

A helper method 


private Element createItems(ArrayList<LineItem> items) 


for the items element is implemented in the same way—see the program listing at 
the end of this section. 
Now you build the document as follows: 


ArrayList<LineItem> items =... .; 
doc = builder.newDocument(); 
Element root = createItems(items); 
doc.appendChi ldCroot) ; 
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«interface» «interface» ~ 
Fa Ee . 
Document - -Node- 
«interface» «interface» 


Element CharacterData 


«interface» 
T@Xt 


Figure 7 UML Diagram of DOM Interfaces Used in This Chapter 


Once you have built the document, you will want to write it to a file. The DOM 
standard provides the LSSerializer interface for this purpose. Unfortunately, the 
DOM standard uses very generic methods, which makes the code that is required to 
obtain a serializer object look like a “magic incantation”: 


DOMImplementation impl = doc.getImplementation() ; 
DOMImplementationLS imp1LS 

= (DOMImplementationLS) imp].getFeatureC"LS", "3.0"); 
LSSerializer ser = impILS.createLSSerializerQ ; 


Once you have the serializer object, you simply use the writeToString method: 
String str = ser.writeToString(doc) ; 


By default, the LsSerializer produces an XML document without spaces or line 
breaks. As a result, the output looks less pretty, but it is actually more suitable for 
parsing by another program because it is free from unnecessary white space. 

If you want white space, you use yet another magic incantation after creating the 
serializer: 


ser.getDomConfig().setParameter("format-pretty-print", true); 


Here is an example program that shows how to build an XML document and print it. 


ch23/builder/ItemListBuilder.java 


import java.util.ArrayList; 

import javax.xml.parsers.DocumentBui Ider; 

import javax.xml.parsers.DocumentBui lderFactory; 
import javax.xml.parsers.ParserConfigurationException; 
import org.w3c.dom.Document; 

import org.w3c.dom.Element; 

import org.w3c.dom.Text; 


SIG) UT & WN 
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Builds a DOM document for an array list of items. 


public class ItemListBuilder 


ste ale 
awa. 


Constructs an item list builder. 


* / 
public ItemListBui lder@ 
throws ParserConfigurationException 


{ 
DocumentBuilderFactory factory 
= DocumentBui lderFactory.newInstance() ; 
builder = factory.newDocumentBui Ider () ; 
} 
[ee 
Builds a DOM document for an array list of items. 
@param items the items 
@return a DOM document describing the items 
ia 


public Document build(ArrayList<LineItem> items) 


{ 
doc = builder.newDocument() ; 
doc.appendChi ld(createItems (items) ) ; 
return doc; 


Builds a DOM element for an array list of items. 
@param items the items 
@return a DOM element describing the items 

% / 


private Element createItems(ArrayList<LineItem> items) 
Element e = doc.createElementC"items"); 


for (LineItem anItem : items) 
e.appendChi ldCcreateItem(CanItem) ) ; 


return €; 


[** 
Builds a DOM element for an item. 
@param anItem the item 
@return a DOM element describing the item 
* / 
private Element createItem(LineItem anItem) 
{ 


Element e = doc.createElement("item"); 


e.appendChi ldCcreateProduct CanItem.getProduct())); 
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62 e.appendChi 1d(createTextElement( 

63 "quantity", "" + anItem.getQuantity())); 
64 

65 return @; 

66 [ 

67 

68 [ee 

69 Builds a DOM element for a product. 

70 @param p the product 

S @return a DOM element describing the product 
7 */ 

73 private Element createProduct(Product p) 

74 

75 Element e = doc.createElement("product"); 
76 

77 e.appendChi Id(createTextElement( 

78 "description", p.getDescription(Q)); 
79 e.appendChi Id(createTextElement ( 

80 "price", "" + p.getPrice())); 

81 

82 return @; 

83 } 

84 

85 private Element createTextElement(String name, String text) 
86 { 

87 Text t = doc.createTextNode(text) ; 

88 Element e = doc.createElement(name) ; 

89 e.appendChi Id(t) ; 

90 return @; 

91 } 

92 

93 private DocumentBuilder builder; 

94 private Document doc; 

95 } 


ch23/builder/ItemListBuilderDemo.java 


1 import java.util.ArrayList; 

2 import org.w3c.dom.DOMImplementation; 

3 import org.w3c.dom.Document; 

4 import org.w3c.dom.1s.DOMImplementationLs; 
5 =import org.w3c.dom.1s.LSSerializer; 
6 

Z 

8 

9 


J* ve 

This program demonstrates the item list builder. It prints the XML 

file corresponding to a DOM document containing a list of items. 
10 * 
11 public class ItemListBuilderDemo 
Ae 
13 public static void main(StringL] args) throws Exception 
14 { 
15 ArrayList<LineItem> items = new ArrayList<LinelItem>(); 
16 items.add(new LineItem(new Product("Toaster", 29.95), 3)); 
17 items.add(new LineItem(new Product("Hair dryer", 24.95), 1)); 
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18 

19 ItemListBuilder builder = new ItemListBuilder(); 

20 Document doc = builder.build(Citems); 

21 DOMImplementation imp] = doc.getImplementationQ() ; 

Zz DOMImplementationLS imp1LS 

23 = (DOMImplementationLS) impl.getFeature("LS", "3.0"); 
24 LSSerializer ser = impILS.createLSSerializer( ; 
25 String out = ser.writeToString(doc) ; 

26 

27 System.out.printIn(out) ; 

28 ; 

29 } 


This program uses the Product and LineItem classes from Chapter 12. The LineItem 
class has been modified by adding getProduct and getQuantity methods. 


Output 


<?xml version="1.0" encoding="UTF-8"?><items><item><product> 
<description>Toaster</description><price>29.95</price></product> 
<quantity>3</quantity></item><item><product><description>Hair dryer 
</description><price>24.95</price></product><quantity>1</quantity> 
</item></items> 


SELF CHECK 


6. Suppose you need to construct a Document object that represents an XML docu- 
ment other than an item list. Which methods from the ItemListBuilder class can 
you reuse? 


7. How would you write a document to the file output. xm1? 


How To 23.2 


Writing an XML Document 


What is the best way to write an XML document? This How To shows you how to produce 
a Document object and how to generate an XML document from it. 


Step 1 Provide the outline of a document builder class. 


To construct the Document object from an object of some class, you should implement a class 
such as this one: 


public class MyBuilder 


4 
public Document build(SomeClass x) { ... } 


private Element createTextElement(String name, String text) 


{ 
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Text t = doc.createTextNode(text) ; 
Element e = doc.createElement(name) ; 
e.appendChi ld(t) ; 

return e; 


} 


private DocumentBuilder builder; 
private Document doc; 


} 
Step 2. Look at the format of the XML document that you want to create. 


Consider all elements, except for those that only have text content. Find the matching Java 
classes. In the ItemListBuilder example, we ignore quantity, description, and price 
because they have text content. The remaining elements and their Java classes are 


® product - Product 
® jtem - LineItem 


® items - ArrayList<LineItem> 
Step 3. For each element in Step 2, add a helper method to your builder class. 


Each helper method has the form 
private Element createElementName(ClassForElement x) 
For example, 


public class MyBui lder 


{ 
public Document build(ArrayList<LineItem> x) { .. . } 
private Element createProduct(Product x) {... } 
private Element createItem(LineItem x) {... } 
private Element createItems(ArrayList<LineItem> x) {.. . } 
i 


Step 4 Implement the helper methods. 


For each element, call the helper methods of its children. However, if a child has text content, 
call createTextElement instead. 

For example, the item element has two children: product and quantity. The former has a 
helper method, and the latter has text content. Therefore, the createItem method calls 
createProduct and createTextElement: 


private Element createItem(LineItem anItem) 


{ 
Element e = doc.createElement("item") ; 
e.appendChi |ld(createProduct(anitem.getProduct())); 
e.appendChi Id(createTextElementC"quantity", "" + anItem.getQuantity()); 
return e; 
} 


You may find it helpful to implement the helper methods “bottom up”, starting with the 
simplest method (such as createProduct) and finishing with the method for the root element 
(createItems). 
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Step 5 Finish off your builder by writing a constructor and the build method. 


public class MyBuilder 


: 
public MyBui lder(d) 
throws ParserConfigurationException 
{ 
DocumentBuilderFactory factory 
= DocumentBui lderFactory.newInstance() ; 
builder = factory.newDocumentBui Ider() ; 
} 
public Document build(ClassForRootElement x) 
{ 
doc = builder.newDocument() ; 
doc. appendChi 1d (createRootElementName(x)) ; 
return doc; 
; 
} 


Step 6 Use a class, such as the LSSerializer, to convert the Document to a string. 


For example, 


Invoice x=... .3 

InvoiceBuilder builder = new InvoiceBuilder(); 
Document doc = builder.build(x); 

LSSerializer ser=.. .3 

String str = ser.writeToString(doc) ; 


23.4 


Validating XML Documents 


In this section you will learn how to specify rules for XML documents of a particu- 
lar type. There are several mechanisms for this purpose. The oldest and simplest 
mechanism is a Document Type Definition (DTD), the topic of this section. We dis- 


cuss other mechanisms in Advanced Topic 23.1. 


23.4.1 Document Type Definitions 


A DTD is a sequence of 
rules that describes the 
valid child elements and 
attributes for each 


element type. 


description. 
A DTD 1s a sequence of rules that describes 


° The valid attributes for each element type 
e The valid child elements for each element type 


Consider a document of type items. Intuitively, items denotes a 
sequence of item elements. Each item element contains a product and 
a quantity. A product contains a description and a price. Each of 
these elements contains text describing the product’s description, 
price, and quantity. The purpose of a DTD is to formalize this 
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Table 2 Replacements for Special Characters 


Character Encoding Name 
< &1t; Less than (left angle bracket) 
> &gt; Greater than (right angle bracket) 
& &amp ; Ampersand 
&apos; Apostrophe 
2 &quot ; Quotation mark 


Let us first turn to child elements. The valid child elements of an element are 
described by an ELEMENT rule: 


<!ELEMENT items (Citem*)> 


This means that an item list must contain a sequence of 0 or more item elements. 
As you can see, the rule is delimited by <! . . . >, and it contains the name of the 
element whose children are to be constrained (items), followed by a description of 
what children are allowed. 
Next, let us turn to the definition of an item node: 


<!ELEMENT item (product, quantity)> 


This means that the children of an item node must be a product node, followed by a 
quantity node. 
The definition for a product is similar: 


<!ELEMENT product (description, price)> 
Finally, here are the definitions of the three remaining node types: 


<!ELEMENT quantity C#PCDATA)> 
<!ELEMENT description (#PCDATA)> 
<!ELEMENT price C#PCDATA)> 


The symbol #PcpaTA refers to text, called “parsed character data” in XML terminol- 
ogy. The character data can contain any characters. However, certain characters, 
such as < and &, have special meaning in XML and need to be replaced if they occur 
in character data. Table 2 shows the replacements for special characters. 

The complete DTD for an item list has six rules, one for each element type: 

<!ELEMENT items Citem*)> 

<!ELEMENT item Cproduct, quantity)> 

<!ELEMENT product (description, price)> 

<!ELEMENT quantity (C#PCDATA)> 


<!ELEMENT description C#PCDATA)> 
<!ELEMENT price C#PCDATA)> 


Let us have a closer look at the descriptions of the allowed children. Table 3 shows 
the expressions used to describe the children of an element. The EMPTY keyword is 
self-explanatory: an element that is declared as EMPTY may not have any children. 
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Table 3 Regular Expressions for Element Content 


Rule Description Element Content 

EMPTY No children allowed 
CE*) Any sequence of 0 or more elements E 
(E+) Any sequence of 1 or more elements E 
CE?) Optional element E (0 or 1 occurrences allowed) 

Cy, Eas ee) Element Fy, followed by E>,... 

GEES |e) Blement £7.06 F501. -. 

(#PCDATA) Text only 
GEPCDATA [cE | 252s 3) Any sequence of text and elements Fj, E>,..., in any order 

ANY Any children allowed 


For example, the HIML DTD defines the img element to be EMPTY—an image has 
only attributes, specifying the image source, size, and placement, and no children. 

More interesting child rules can be formed with the regular expression operations 
(* + ? , |). (See Table 3 and Figure 8. Also see Productivity Hint 8.2 for more 
information on regular expressions.) You have already seen the * (“0 or more”) and , 
(sequence) operations. The children of an items element are 0 or more item elements, 
and the children of an item are a sequence of product and description elements. 

You can also combine these operations to form more complex expressions. For 
example, 


<!ELEMENT section (title, (paragraph | Cimage, title?))+) 
defines an element section whose children are: 


1. A title element 
2. A sequence of one or more of the following: 
® paragraph elements 


¢ image elements followed by optional title elements 


Thus, 


<section> 
<title/> 
<paragraph/> 
<image/> 
<title/> 
<paragraph/> 

</section> 


is valid, but 


23.4 #8 Validating XML Documents 991 


E Ey E, 
(E «) (Ey, Ey) 

iE 

Ey 
(E+) : 
(E, | £5) 

E 

(E?) 


Figure 8 DTD Regular Expression Operations 


<section> 

<paragraph/> 
<paragraph/> 
<title/> 

</section> 
is not—there is no starting title, and the title at the end doesn’t follow an image. 

You already saw the (#PCDATA) rule. It means that the children can consist of any 
character data. For example, in our product list DTD, the description element can 
have any character data inside. 

You can also allow mixed content—any sequence of character data and specified 
elements. However, in mixed content, you have no control over the order in which 
the elements appear. As explained in Quality Tip 23.2, you should avoid mixed con- 
tent for DTDs that describe data sets. This feature is intended for documents that 
contain both text and markup instructions, such as HTML pages. 

Finally, you can allow a node to have children of any type—you should avoid 
that for DTDs that describe data sets. 

You now know how to specify what children a node may have. A DTD also 
gives you control over the allowed attributes of an element. An attribute descrip- 
tion looks like this: 


<!ATTLIST Element Attribute Type Default> 


The most useful attribute type descriptions are listed in Table 4. The CDATA type 
describes any sequence of character data. As with #PCDATA, certain characters, such 
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Table 4 Common Attribute Types 


Type Description Attribute Type 
CDATA Any character data 
CV; | V> | ae One of V5 V>, o sece 


as < and &, need to be encoded (as &1t;, &amp; and so on). There is no practical differ- 
ence between the CDATA and #PCDATA types. Simply use CDATA in attribute declarations 
and #PCDATA in element declarations. 

Rather than allowing arbitrary attribute values, you can specify a finite number 
of choices. For example, you may want to restrict a currency attribute to U.S. dollar, 
euro, and Japanese yen. Then use the following declaration: 


<!ATTLIST price currency CUSD | EUR | JPY) #REQUIRED> 


You can use letters, numbers, and the hyphen (-) and underscore (_) characters for 
the attribute values. 

There are other type descriptions that are less common in practice. You can find 
them in the XML reference [1]. 

The attribute type description is followed by a “default” declaration. The key- 
words that can appear in a “default” declaration are listed in Table 5. 

For example, this attribute declaration describes that each price element must 
have a currency attribute whose value is any character data: 


<!ATTLIST price currency CDATA #REQUIRED> 


To fulfill this declaration, each price element must have a currency attribute, such as 
<price currency="USD">. A price without a currency would not be valid. 
For an optional attribute, you use the #IMPLIED keyword instead. 


<!ATTLIST price currency CDATA #IMPLIED> 


That means that you can supply a currency attribute in a price element, or you can 
omit it. If you omit it, then the application that processes the XML data implicitly 
assumes some default currency. 


Table 5 Attribute Defaults 


Default Declaration Explanation 
#REQUIRED Attribute is required 
#IMPLIED Attribute is optional 
V Default attribute, to be used if attribute is not specified 


#FIXED V Attribute must either be unspecified or contain this value 
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A better choice would be to supply the default value explicitly: 
<!ATTLIST price currency CDATA "USD"> 


That means that the currency attribute is understood to mean USD if the attribute is 
not specified. An XML parser will then report the value of currency as USD if the 
attribute was not specified. 

Finally, you can state that an attribute can only be identical to a particular value. 
For example, the rule 


<!ATTLIST price currency CDATA #FIXED "USD"> 


means that a price element must either not have a currency attribute at all (in which 
case the XML parser will report its value as USD), or specify the currency attribute as 
USD. Naturally, this kind of rule is not very common. 

You have now seen the most common constructs for DTDs. Using these con- 
structs, you can define your own DTDs for XML documents that describe data 
sets. In the next section, you will see how to specify which DTD an XML docu- 
ment should use, and how to have the XML parser check that a document conforms 


to its DTD. 


_ 23.4.2 Specifying a DTD in an XML Document 


An XML document can 
contain its DTD or refer to 
a DTD that is stored 
elsewhere. _ 


When you reference a DID with an XML document, you can instruct the parser to 
check that the document follows the rules of the DTD. That way, the parser can 
check errors in the document. 

In the preceding section you saw how to develop a DTD for a 
class of XML documents. The DTD specifies the permitted elements 
and attributes in the document. An XML document has two ways of 
referencing a DTD: 


1. The document may contain the DTD. 
2. The document may refer to a DTD that is stored elsewhere. 


A DTD is introduced with the poctyPe declaration. If the document contains its 
DTD, then the declaration looks like this: 


<!DOCTYPE rootElement [ rules |> 
For example, an item list can include its DTD like this: 


<?xml version="1.0"?> 
<!DOCTYPE items [ 


<!ELEMENT items Citem*)> 

<!ELEMENT item (product, quantity)> 
<!ELEMENT product (description, price)> 
<!ELEMENT quantity C#PCDATA)> 

<!ELEMENT description C#PCDATA)> 
<!ELEMENT price (#PCDATA)> 


|> 


<items> 
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<item> 
<product> 


<description>Ink Jet Refill Kit</description> 
<price>29.95</price> 


</product> 
<quantity>8</quantity> 


</item> 
<item> 


<product> 


<description>4-port Mini Hub</description> 
<price>19.95</price> 


</product> 
<quantity>4</quantity> 


</item> 


</items> 


When referencing an 
external DTD, you must 
supply an URL for locating 

the DTD. 


However, if the DTD is more complex, then it is better to store it 
outside the XML document. In that case, you use the SYSTEM key- 
word inside the DOCTYPE declaration to indicate that the system that 
hosts the XML processor must locate the DTD. The system keyword 
is followed by the location of the DTD. For example, a DocTyPE dec- 
laration might point to a local file 


<!DOCTYPE items SYSTEM "jtems.dtd'"> 


Alternatively, the resource might be an URL anywhere on the Web: 


<!DOCTYPE items SYSTEM "http://ww.mycompany.com/dtds/items.dtd"> 


For commonly used DTDs, the DoctyPe declaration can contain a PUBLIC keyword. 


For example, 


<!DOCTYPE faces-config PUBLIC 
"-//Sun Microsystems, Inc.//DTD JavaServer Faces Config; 1:07 7EN" 
“http: //java.sun.com/dtd/web-facesconfig_1_ 0.dtd"> 


A program parsing the DTD can look at the public identifier. If it is a familiar iden- 
tifer, then it need not spend time retrieving the DTD from the URL. 


Spe EPEAT EY Ot 
Henge ae = Farts Se Ge FS Hg < 
eset arte, Se Sry ee gt oe Nie 


When your XML document _ 
hasaDTD, youcan 
request validation when 
parsing. ie 


When you include a DTD with an XML document, then you can tell 
the parser to validate the document. That means that the parser will 
check that all child elements and attributes of an element conform to 
the ELEMENT and ATTLIST rules in the DTD. If a document is invalid, 
then the parser reports an error. To turn on validation, you use the 


setValidating method of the DocumentBui lderFactory class before calling the new- 
DocumentBui Ider method: 


DocumentBuilderFactory factory = DocumentBui IderFactory.newInstance(); 
factory.setValidating(true); 

DocumentBuilder builder = factory.newDocumentBui lder(): 

Document doc = builder.parse(. . .); 
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Validation can simplify your code for processing XML documents. For example, if 
the DTD specifies that the child elements of each item element are product and 
quantity elements in that order, then you can rely on that fact and don’t need to put 
tedious checks in your code. 

If the parser has access to the DTD, it can make another useful 
improvement. By default, the parser converts all spaces in the input 
document to text, even if the spaces are only used to logically line up 
elements. As a result, the document contains text nodes that are 
wasteful and can be confusing when you analyze the document tree. 

To make the parser ignore white space, call the setIgnoringElementContent- 
Whitespace method of the DocumentBui lderFactory class. 


When you parse an XML 
file with a DTD, tellthe 
_ parser to ignore white 
Pspaces sew ae te 


factory.setValidating(true) ; 
factory.setIgnoringElementContentWhitespace(true) ; 


Finally, if the parser has access to the DTD, it can fill in default values for attributes. 
For example, suppose a DTD defines a currency attribute for a price element: 


<!ATTLIST price currency CDATA "USD"> 


If a document contains a price element without a currency attribute, then the parser 


can supply the default: 


String attributeValue = priceElement.getAttributeC"currency'); 
// Gets "USD" if no currency specified 

This concludes our discussion of XML. You now know enough XML to put it to 
work for describing data formats. Whenever you are tempted to use a “quick and 
dirty” file format, you should consider using XML instead. By using XML for data 
interchange, your programs become more professional, robust, and flexible. This 
chapter covers the most important aspects of XML for everyday programming. For 
more advanced features that can be useful in specialized situations, please see [1]. 
Furthermore, XML technology is still undergoing rapid change at the time of this 
writing. Therefore, it is a good idea to check out the latest developments. Good web 
sites are [5] and [6]. 


SELF CHECK 


8. How cana DTD specify that the quantity element in an item is optional? 


9. How cana DTD specify that a product element can contain a description and a 
price element, in any order? 


10. How cana DTD specify that the description element has an optional attribute 
language? 
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How To 23.3 


Writing a DID 


You write a DTD to describe a set of XML documents of the same type. The DTD specifies 
which elements contain child elements (and the order in which they may appear) and which 
elements contain text. It also specifies which elements may have attributes, which attributes 
are required, and which defaults are used for missing attributes. 

These rules are for DTDs that describe program data. DTDs that describe narrative text 
generally have a much more complex structure. 


Step 1 Get or write a couple of sample XML documents. 


For example, if you wanted to make a DTD for XML documents that describe an invoice, 
you could study samples such as the one in How To 23.1. 


Step 2. Make a list of all elements that can occur in the XML document. 


In the invoice example, they are 
® invoice 

® address 

© name 

® street 

® city 

® state 

@ zip 

® items 

® item 

@® product 

e@ description 


® quantity 
Step 3 For each of the elements, decide whether its children are elements or text. 


Following Quality Tip 23.2, it is best to avoid elements whose children are a mixture of both. 
In the invoice example, the following elements have element content: 


® invoice 
® address 
® items 

® item 

© product 


The remainder contain text. 


Step 4 For elements that contain text, the DTD rule is 


<!ELEMENT elementName (#PCDATA)> 
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Thus, we have the following simple rules for the invoice elements that contain text: 


<!ELEMENT name (#PCDATA)> 
<!ELEMENT street (#PCDATA)> 
<!ELEMENT city C#PCDATA)> 
<!ELEMENT state C#PCDATA)> 
<!ELEMENT zip C#PCDATA)> 
<!ELEMENT quantity (#PCDATA)> 
<!ELEMENT description (#PCDATA)> 


Step 5 For each element that contains other elements, make a list of the possible child 
elements. 


Here are the lists in the invoice example: 


Invoice 
® address 
® items 


address 
® name 
street 
city 
state 
Z1p 


® &¢ &@ @ 


items 

® item 
item 

® product 
® quantity 


product 
® description 
® price 


Step 6 For each of those elements, decide in which order the child elements should occur 
and how often they should occur. 
Then form the rule 

<!ELEMENT elementName child, count,, child, county, . . .> 


where each count is one of the following: 


Quantity Count 
Oorl ? 
1 omit 
O or more 
1 or more + 
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In the invoice example, the items element can contain any number of items, so the rule is 
<!ELEMENT items (item*)> 
In the remaining cases, each child element occurs exactly once. That leads to the rules 


<!ELEMENT invoice (address, items)> 

<!ELEMENT address (name, street, city, state, zip)> 
<!ELEMENT item (product, quantity)> 

<!ELEMENT product (descripton, price)> 


Step 7 Decide whether any elements should have attributes. 


Following Quality Tip 23.1, it is best to avoid attributes altogether or to minimize the use of 
attributes. Because we have no good reason to add attributes in the invoice example, our 
invoice is complete without attributes. 


ADVANCED TOPIC 23.1 


Schema Languages 


Several mechanisms have been developed to deal with the limitations of DTDs. DTDs can- 
not express certain details about the structure of an XML document. For example, you can’t 
force an element to contain just a number or a date—any text string is allowed for a 
(#PCDATA) element. 

The XML Schema specification is one mechanism for overcoming these limitations. An 
XML schema is like a DTD in that it is a set of rules that documents of a particular type need 
to follow, but a schema can contain far more precise rule descriptions. 

Here is just a hint of how an XML schema is specified. For each element, you specify the 
element name and the type. For example, this definition restricts the contents of quantity to 
an integer. 


<xsd:element name="quantity" type="xsd:integer"/> 


Note that an XML schema is itself written in XML —unlike a DTD, which uses a completely 
different syntax. (The xsd: prefix is a name space prefix to denote that xsd:element and 
xsd: integer are part of the XML Schema Definition name space. See Advanced Topic 23.2 
for more information about name spaces. ) 

In XML Schema, you can define complex types, much as you define classes in Java. Here 
is the definition of an Address type: 


<xsd:complexType name="Address"> 
<xsd:sequence> 
<xsd:element name="name" type="xsd:string"/> 
<xsd:element name="street" type="xsd:string"/> 
<xsd:element name="city" type="xsd:string"/> 
<xsd:element name="state" type="xsd:string"/> 
<xsd:element name="zip" type="xsd:string"/> 
</xsd:sequence> 
</xsd:complexType> 


Then you can specify that an invoice should have shipto and bil1to fields that are both of 
type Address: 
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<xsd:element name="Shipto" type="Address"/> 
<xsd:element name="billto" type="Address"/> 


These examples show that an XML schema can be more precise than a DTD. 

The XML Schema specification has many advanced features—see the W3C web site [5] 
for details. However, some programmers find that specification overly complex and instead 
use a competing standard called Relax NG—see [7]. Relax NG is simpler than XML Schema, 
and it shares a feature with DTDs: a compact notation that is not XML. For example, in 
Relax NG, you simply write 


element quantity { xsd:integer } 


to denote that quantity is an element containing an integer. The designers of Relax NG real- 
ized that XML, despite its many advantages, is not always the best notation for humans. 


ADVANCED TOPIC 23.2 


Other XML Technologies 


This chapter covers the subset of the XML 1.0 specification that is most useful for common 
programming situations. Since version 1.0 of the XML specification was released, there has 
been a huge amount of interest in advanced XML technologies. A number of useful technol- 
ogies have recently been standardized. Among them are: 


e Schema Definitions 
e Name Spaces 


XHTML 


XSL and Transformations 


Advanced Topic 23.1 contains more information about schema definitions. 

Name spaces were invented to ensure that many different people and organizations can 
develop XML documents without running into conflicts with element names. For example, 
if you look inside Advanced Topic 23.1, you will see that XML Schema definitions have ele- 
ment names that are prefixed with a tag xsd:, such as 


<xsd:element name="city" type="xsd: string" /> 


That way, the tag and attribute names, such as element and string, don’t conflict with other 
names. In that regard, name spaces are similar to Java packages. However, a name space pre- 
fix such as xsd: is just a shortcut for the actual name space identifier, which is a much longer, 
unique string. For example, the full name space for XML Schema definitions is http: // 
www .w3.org/2000/08/XMLSchema. Each schema definition starts out with the statement 


<xsd:schema xmlns:xsd="http: //www.w3.org/2000/08/XMLSchema"> 


which binds the xsd prefix to the full name space. 

XHTML is the most recent recommendation of the W3C for formatting web pages. 
Unlike HTML, XHTML is fully XML-compliant. Once web-editing tools switch to 
XHTML, it will become much easier to write programs that parse web pages. The XHTML 
standard has been carefully designed to be backwards compatible with existing browsers. 

While XHTML documents are intended to be viewed by browsers, general XML docu- 
ments are not designed to be viewed at all. Nevertheless, it is often desirable to transform an 
XML document into a viewable form. XSL (Extensible Stylesheet Language) was created for 
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this purpose. A style sheet indicates how to change an XML document into an HTML docu- 
ment, or even a completely different format, such as PDE 

For more information on these and other emerging technologies, see the W3C web 
site [5]. 


CHAPTER SUMMARY 


1. XML allows you to encode complex data, independent from any programming 
language, in a form that the recipient can easily parse. 


. XML files are readable by computer programs and by humans. 
. XML-tformatted data files are resilient to change. 


XML describes the meaning of data, not how to display them. 


. An XML document starts out with an XML declaration and contains elements 
and text. 


6. An element can contain text, child elements, or both (mixed content). For data 
descriptions, avoid mixed content. 


7. Elements can have attributes. Use attributes to describe how to interpret the 
element content. 


8. A parser is a program that reads a document, checks whether it is syntactically 
correct, and takes some action as it processes the document. 


9. A streaming parser reports the building blocks of an XML document. A tree- 
based parser builds a document tree. 


10. A DocumentBuilder can read an XML document from a file, URL, or input 
stream. [he result is a Document object, which contains a tree. 


11. The Document interface has methods to create elements and text nodes. 


12, A DTD is a sequence of rules that describes the valid child elements and 
attributes for each element type. 


13. An XML document can contain its DID or refer to a DTD that is stored 


elsewhere. 


14, When referencing an external DTD, you must supply an URL for locating 
the DTD. 


15. When your XML document has a DTD, you can request validation when 
parsing. 


16. When you parse an XML file with a DTD, tell the parser to ignore white space. 
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FURTHER READING 


omk 


. http://ww.xml.com/axml/axm].html Annotated XML specification. 


http://ww.w3.org/TR/xpath The XPath specification. 


http://www. zvon.org/xx1/XPathTutorial/General/examples.htm] An interactive 
XPath tutorial. 


http://java.sun.com/docs/books/jls James Gosling et al., The Java Language 
Specification, 3rd ed., Prentice-Hall, 2005. 


http: //ww.w3c.org/xml The W3C XML web site. 


. http://java.sun.com/xml The Sun Microsystems XML web site. 


http: //www.relaxng.org/ ‘The web site for the Relax NG schema language. 


CLASSES, OBJECTS, AND METHODS 
INTRODUCED IN THIS CHAPTER 


javax.xml.parsers.DocumentBui Ider 
newDocument 
parse 
javax.xml.parsers.DocumentBui lderFactory 
newDocumentBui Ider 
newInstance 
setIgnoringE]ementContentwWhitespace 
setValidating 
javax.xml.xpath.XPath 
evaluate 
javax.xm].xpath.XPathExpressionException 
javax.xml.xpath.xXPathFactory 
newInstance 
newxXPath 
org.w3c.dom.Document 
createElement 
createTextNode 
getImplementation 
org.w3c.dom.DOMConfiguration 
setParameter 
org.w3c.dom.DOMImplementation 
getFeature 
org.w3c.dom.Element 
getAttribute 
setAttribute 
org.w3c.dom.1s.DOMImplementationLS 
createLSSerializer 
org.w3c.dom.1s.LSSerializer 
getDomConfig 
writeToString 
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REVIEW EXERCISES _ 


Exercise R23.1. Give some examples to show the differences between XML and 
HTML. 


Exercise R23.2. Design an XML document that describes a bank account. 


Exercise R23.3. Draw a tree view for the XML document you created in Exercise 
R252, 


Exercise R23.4. Write the XML document that corresponds to the parse tree in 
Figure 5. 


Exercise R23.5. Write the XML document that corresponds to the parse tree in 
Figure 6. 


Exercise R23.6. Make an XML document describing a book, with child elements for 
the author name, the title, and the publication year. 


Exercise R23.7. Add a description of the book’s language to the document of the pre- 
ceding exercise. Should you use an element or an attribute? 


Exercise R23.8. What is mixed content? What problems does it cause? 


Exercise R23.9. Design an XML document that describes a purse containing three 
quarters, a dime, and two nickels. 


Exercise R23.10. Explain why a paint program, such as Microsoft Paint, is a 
WYSIWYG program that is also “what you see is all you’ve got”. 


Exercise R23.11. Consider the XML file 


<purse> 
<coin> 
<value>0.5</value> 
<name lang="en">half dollar</name> 
</coin> 
<coin> 
<value>0. 25</value> 
<name lang="en">quarter</name> 
</coin> 
</purse> 


What are the values of the following XPath expressions? 
a. /purse/coin[1]/value 
b. /purse/coin[2]/name 
c /purse/coin[2]/name/@lang 
d. name(/purse/coin[2]/*[1]) 
€. count(/purse/coin) 
f 


- count(/purse/coin[2]/name) 
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Exercise R23.12. With the XML file of Exercise R23.11, give XPath expressions that 
yield the following: 


a. the value of the first coin 

b. the number of coins 

c. the name of the first child element of the first coin element 
d 


. the name of the first attribute of the first coin’s name element. (The expression 
@* selects the attributes of an element.) 


e. the value of the lang attribute of the second coin’s name element 
Exercise R23.13. Design a DTD that describes a bank with bank accounts. 


Exercise R23.14. Design a DTD that describes a library patron who has checked out 
a set of books. Each book has an ID number, an author, and a title. The patron has a 
name and telephone number. 


Exercise R23.15. Write the DTD file for the following XML document 


<?xml version="1.0"?> 
<productlist> 
<product> 
<name>Comtrade Tornado</name> 
<price currency="USD">2495</price> 
<score>60</score> 
</product> 
<product> 
<name>AMAX Powerstation 75</name> 
<price>2999</price> 
<score>62</score> 
</product> 
</productlist> 


Exercise R23.16. Design a DTD for invoices, as described in How To 23.3. 


Exercise R23.17. Design a DTD for simple English sentences, as described in Random 
Fact 23.2. 


Exercise R23.18. Design a DTD for arithmetic expressions, as described in Random 
Pact.23:2: 


Additional review exercises are available in WileyPLUS. 


PROGRAMMING EXERCISES 


Exercise P23.1. Write a program that can read XML files, such as 


<purse> 
<coin> 
<value>0.5</value> 
<name>half dol lar</name> 
</coin> 
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</purse> 


Your program should construct a Purse object and print the total value of the coins 
in the purse. 


Exercise P23.2. Building on Exercise P23.1, make the program read an XML file as 
described in that exercise. Then print an XML file of the form 


<purse> 
<coins> 
<coin> 
<value>0.5</value> 
<name>half dol lar</name> 
</coin> 
<quanti ty>3</quantity> 
</coins> 
<coins> 
<coin> 
<value>0.25</value> 
<name>quarter</name> 
</coin> 
<quantity>2</quantity> 
</coins> 
</purse> 


Exercise P23.3. Repeat Exercise P23.1, using a DTD for validation. 
Exercise P23.4. Write a program that can read XML files, such as 


<bank> 
<account> 
<number>3</number> 
<balance>1295.32</balance> 
</account> 


</bank> 
Your program should construct a Bank object and print the total value of the bal- 
ances in the accounts. 


Exercise P23.5. Repeat Exercise P23.4, using a DTD for validation. 


Exercise P23.6. Enhance Exercise P23.4 as follows: First read the XML file in, then 
add 10% interest to all accounts, and write an XML file that contains the increased 
account balances. 


Exercise P23.7, Write a DTD file that describes documents that contain information 
about countries: name of the country, its population, and its area. Create an XML 


file that has five different countries. The DTD and XML should be in different files. 
Write a program that uses the XML file you wrote and prints: 


e The country with the largest area 
e The country with the largest population 


¢ The country with the largest population density (people per square 
kilometer) 
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xx Exercise P23.8. Write a parser to parse invoices using the invoice structure described 
in How To 23.1. The parser should parse the XML file into an Invoice object and 
print out the invoice in the format used in Chapter 12. 


wk Exercise P23.9. Modify Exercise P23.8 to support separate shipping and billing 
addresses. Supply a modified DTD with your solution. 


x Exercise P23.10. Write a document builder that turns an invoice object, as defined in 
Chapter 12, into an XML file of the format described in How To 23.1. 


www Exercise P23.11. Modify Exercise P23.10 to support separate shipping and billing 
addresses. 


*G Exercise P23.12. Write a program that can read an XML document of the form 


<rectangle> 
<x>5</xX> 
<y>1l0</y> 
<width>20</width> 
<height>30</height> 
</rectangle> 


and draw the shape in a window. 


*G Exercise P23.13. Write a program that can read an XML document of the form 


<ellipse> 
<x>5</x> 
<y>10</y> 
<width>20</width> 
<height>30</height> 
</ellipse> 


and draw the shape in a window. 


w**G Exercise P23.14. Write a program that can read an XML document of the form 


<rectangularshape shape="ellipse'> 
<x>5</X> 
<y>10</y> 
<width>20</width> 
<height>30</height> 
</rectangularshape> 


Support shape attributes "rectangle", "roundrectangle", and "ellipse". 


Draw the shape in a window. 


**G Exercise P23.15. Write a program that can read an XML document of the form 
<polygon> 
<point> 
<Xx>5</Xx> 
<y>10</y> 
</point> 


</polygon> 


and draw the shape in a window. 
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kG Exercise P23.16. Write a program that can read an XML document of the form 


<drawing> 
<rectangle> 
<x>5</xX> 
<y>10</y> 
<width>20</width> 
<height>30</height> 
</rectangle> 
<line> 
<X1>5</x1> 
<y1>10</y1> 
<X2>25</x2> 
<y2>40</y2> 
</line> 
<message> 
<text>Hello, World! </text> 
<x>20</x> 
<y>30</y> 
</message> 
</drawing> 


and show the drawing in a window. 


*kkG Exercise P23.17. Repeat Exercise P23.16, using a DTD for validation. 


(ine Additional programming exercises are available in WileyPLUS. 
WILEY 


PROGRAMMING PROJECTS 


wk Project 23.1. Following Exercise P12.7, design an XML format for the appointments 
in an appointment calendar. Write a program that first reads in a file with appoint- 
ments, then another file of the format 


<commands> 
<add> 
<appointment> 


</appointment> 
</add> 
<remove> 
<appointment> 
</appointment> 
</remove> 
</commands> 


Your program should process the commands and then produce an XML file that 
consists of the updated appointments. 


kk Project 23.2. Write a program to simulate an airline seat reservation system, using 
XML documents. Reference Exercise P12.8 for the airplane seat information. The 
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program reads a seating chart, in an XML format of your choice, and a command 
file, in an XML format of your choice, similar to the command file of the preceding 
exercise. [hen the program processes the commands and produces an updated seat- 
ing chart. 


ANSWERS TO SELF-CHECK QUESTIONS 


1. Your answer should look similar to this: 


<student> 
<name>James Bond</name> 
<1d>007</id> 

</student> 


2. Most browsers display a tree structure that indicates the nesting of the tags. 
Some browsers display nothing at all because they can’t find any HTML tags. 


3. The text hamster. jpg is never displayed, so it should not be a part of the docu- 
ment. Instead, the src attribute tells the browser where to find the image that 


should be displayed. 
4, 29.95. 
5. name(/*[1]). 
6. The createTextElement method is useful for creating other documents. 


7, First construct a string, as described, and then use a PrintWriter to save the 
string to a file. 


8, <!ELEMENT item (product, quantity?)> 
9, <!ELEMENT product ((description, price) | (price, description) )> 
10. <!ATTLIST description language CDATA #IMPLIED> 


CHAPTER GOALS 


To understand the web application concept 


To learn the syntactical elements of the JavaServer Faces web 
application framework 


To learn about navigation in web applications 


To build three-tier web applications 


Web applications are a new type of software that has become very important in 
recent years. Applications for a wide variety of purposes, such as e-mail, banking, 
shopping, and playing games, run on servers and interact with users through a web 
browser. Developing web-based user interfaces is more complex and challenging 
than writing graphical user interfaces. Until recently, only primitive technologies 
(such as Java servlets) were available for this purpose. Fortunately, more capable 
frameworks for web programming have emerged that are roughly analogous to the 
Swing framework for client-side user interface programming. In this chapter, you 
will learn how to write web applications using the JavaServer Faces (JSF) 


framework. 
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CHAPTER CONTENTS 


24.1 The Architecture of a Web 
Application 1010 
ADVANCED Topic 24.1: AJAX 1012 


24.2 The Architecture of a JSF 
Application 1014 


24.3 Deploying a JSF Application 1017 


24.4 JavaBeans Components 1020 
COMMON ERROR 24.1: Fussy JSF Syntax 1027 
How TO 24.1: Designing a Bean 1027 


3 The user ‘interface ofa a 
web application ise 


in HTML format. 


The web pages that are used in a web application contain forms: groups of ele- 
ments to collect user input, such as text fields and buttons. For example, here is the 


ADVANCED Topic 24.2: Session State 
and Cookies 1028 


24.5 JSF Components 1029 


24.6 Navigation Between Pages 1031 
How To 24.2: Building a Web Application 1033 


24.7 A Three-Tier Application 1034 
RANDOM FACT 24.1: Cataloging Your 
Necktie Collection 1043 


A web application is an application whose user interface is displayed 
~ ina web browser. The application program resides on the web server. 
. displayed ir ina web a _ The user fills out form elements and clicks on buttons and links. The 
user inputs are transmitted over the Internet to the server, and the 

server program updates the web page that the user sees (see Figure 1). 

The browser sends information to the server using the HTTP protocol that was 

described in Sections 21.2 and 21.5. The server responds by sending a new web page 


HTML code for a simple form that prompts for a username and password. 


<html> 
<head> 


<title>A Simple Form</title> 


</head> 
<body> 


<form action="login.jsp" method="POST"> 


<p> 
User name: 


<input type="text" 


Password: 


name="username" /> 


<input type="password" name="passwd" /> 


<input type="submit" 


</p> 
</form> 
</body> 
</html> 


name=""Jogin" value="Log in"/> 
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HTTP ——» 


~ Internet I : . ie 5 ae 


Browser Client Web Server 


Figure 1 The Architecture of a Web Application 


Figure 2 shows the form. Note that there are three input elements: a text field, a 
password field, and a submit button. (The HTML tags are summarized in Appendix 

When a submit button is pressed, the form data is submitted to the server. The 
data is formatted according to the rules of the HTTP protocol, using the Post 
request type. The form data consists of the names and values of the form elements, 
formatted in a special way, called “URL encoding”. In our example form, the 
returned data has the following form: 

POST /login.jsp HTTP/1.1 


Content-Type: application/x-ww-form-urlencoded 
Content-Length: 46 


blank line 


username=jqpub1ic&passwd=secret&login=Log%20in 


The web server analyzes the request and sends a new HTML page to the browser. 
The new page might tell the user that the login was successful and ask the user to 
specify another action. Alternatively, the new page might tell the user that the login 
failed. 

This simple example illustrates why it is difficult to implement a web application. 
Imagine what the server program has to do. At any time, it might receive a request 


* |A Simple Form - Firefox _ 


File Edit View History Bookmarks Tools Help 


@ : Y ig € May i file exfthome/cay/simpleform. html a a 


Figure 2 A Simple Form 
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with form data. At that point, the server program has to remember which form it 
has last sent to the client. It then needs to analyze the submitted data, decide what 
form to show next, and produce the HTML tags for that form. 

There are multiple challenges. As described in Advanced Topic 24.2, the HTTP 
protocol is stateless—there is no memory of which form was last sent when a new 
request is received. Generating the HTML tags for a form is tedious. Perhaps most 
importantly, an application that consists of response strategies for a large number of 
request types is very hard to comprehend without additional structure. 

In order to overcome these challenges, various web application frameworks have 
been developed. A web application framework hides the low-level details of analyz- 
ing HTTP and generating HTML from the application programmer. In this chapter, 
you will learn about the JavaServer Faces (JSF) framework, the web framework that 
is a part of the Java Enterprise Edition. You can think of JSF as “Swing for the 
Web”. Both Swing and JSF handle the tedious details of capturing user input and 
painting text fields and buttons. Swing captures mouse and keyboard events and 
paints pixels in a frame. JSF handles form-posting events and paints by emitting 


HTML code. 


SELF CHECK 


1. Why are two different protocols (HTML and HTTP) required by a web 
application? 

2. How cana web application know which user is trying to log in when the infor- 
mation of the sample login screen is submitted? 


ADVANCED TOPIC 24.1 


AJAX 


In Section 24.1, you learned that a web application receives an HTTP request from the 
browser and then sends back an HTML form. The cycle repeats when the user submits the 
next form data. Web application designers and users dislike the “page flip” —the visual dis- 
continuity between pages that is often accompanied by a significant delay, as the browser 
waits for the new form tags. 

The AJAX (Asynchronous JavaScript and XML) technology, invented in 2005, aims to 
solve this problem. In an AJAX application, the browser does not merely display an HTML 
page, but it also executes code written in the JavaScript language. The JavaScript code contin- 
uously communicates with the server program and updates parts of the HTML page. 

One example of an AJAX application is the Google Maps™ mapping service—see 
Figure 3. In a traditional map application, the user might click on a “move North” button 
and then wait until the browser receives the new map image and displays it in a new page. 
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Figure 3 A Google Maps Image with Partially-Fetched Tiles 


The Google Maps application uses AJAX to fetch only the needed tiles, and it fluidly rear- 
ranges the tiles in the current page, without the dreaded page flip. 

AJAX applications are much more difficult to program than regular web applications. 
Frameworks are being proposed to handle these additional challenges. A future version of 
JSF will support AJAX elements, giving the web application programmer the benefit of 
producing a pleasant user experience without having to worry about the intricate details of 
the JavaScript communication channel. 
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The user interface of a JSF application is described by a set of JSF pages. Each JSF 


page has the following structure: 


<html> 
<*@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %> 
<*~@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %> 
<f:view> 
<head> 
<title>Page title</title> 
</head> 
<body> 
<h: form> 
Page contents 
</h:form> 
</body> 
</f:view> 
</html> 


You can think of this as the required “plumbing”, similar to the 
public static void main incantation that is pequired for every Java 
program. As you can see, the plumbing consists of three parts: 


e The taglib directives are required to locate two JSF libraries. Tags 
from the core library have the prefix f: (such as f: view). Tags from 


the HTML library have the prefix h: (such as h: form) 
° All JSF tags (from the core and HTML libraries) must be con- 


tained inside an f: view tag. 


e The h: form tag encloses all user interface elements. 


Here is a concrete example. 


ch24/datetime/index.jsp 


lL <html> 
2 <%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %> 
3 <“%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %> 
4 
5 <f:view> 
6 <head> 
7 <title>The datetime application</title> 
8 </head> 
9 <body> 
10 <h: form 
11 <p>Number of milliseconds since January 1, 1970: 
12 <h:outputText value="#{dateTime.time}"/> 
13 </p> 
14 </h: form 
15 </body> 


16 </f:view> 
17) </html> 


24.2 4& 


The Architecture of a JSF Application ' 1015 


A 


~~ Gl 
Ne : Ss 


Number of milliseconds since January 1, 1970: 1167779444203 


Figure 4 Executing the datetime Web Application 


Figure 4 shows the result of executing the program. 


The purpose of a JSF page is to generate an HTML page. The basic process is as 


follows: 


e The HTML tags that are present in the JSF page (such as title and p) are 
retained. These are the static part of the page: the formatting instructions that do 
not change. 


e The JSF tags are translated into HTML. This translation is dynamic: it depends 


on thes 


tate of Java objects. (Technically, only the h: tags generate HTML. The 


f: tags from the core library describe structural information that the h: tags use 
in the translation process.) 


e The taglib directives are stripped out. 


Figure 5 shows the basic process. The browser requests a JSF page. The page is pro- 
cessed by the JSF container, the server-side software that implements the JSF frame- 


work. The 


JSF container translates all JSF tags into text and HTML tags, yielding a 


pure HTML page. That page is transmitted to the client browser. The browser dis- 


plays the page. 


The JSF container converts — 


a JSF page to an HTML 
_ page, replacing all JSF tags 
with text and HTML tags. 


Figure 6 shows the HTML code that the JSF page generated. It is 
similar to the JSF page; however, the h:outputText tag has been 
replaced by dynamically generated text: the number of milliseconds 
since January 1, 1970. You can use the “View Source” option of your 


browser to see the HTML code. 


JSE Page JSF Container HTML File Web Server Internet Web Browser 


Figure 5 


The JSF Container Rewrites the Requested Page 


1016 CHAPTER 24 


_ Edit 
| <html> 


|< Tome 


Figure 


The Java objects 0 of a SF 


Source: of: f: https loc calhost: it: 8080) ide atet time; stindex. faces ° - Fire eft HEX 


<head> 


<j 
<body> 


| <form id="j_id_idi2" name="j_id_idi2" method="post" 
| action=" /datetime/ index. faces" 

| enctype="application/x-www-form-urlencaded"> 

| <input type="hidden" name="j_id_idl2" value="j_id_idil2" f> 
| <input type="hidden" name="javax. faces, ViewState" 
| id=" javax. faces. ViewState" value="j_idi:j_id2" /» 


<body> 


ea configuration file. = 


= Web Applications 


view a9 


<titlesThe datetime application</title> 
head> 


ep>humber of milliseconds since January 1, 1978; 
LIG7FFHAASO3 
“7 p> 


| <shiml> 


6 The HTML Code Generated by a JSF Page 


If you look closely at the h: outputText tag in the index. jsp file of the 
~ sample application, you will notice a value binding #{dateTime. time}. 
Value bindings link JSF pages with Java objects. The Java objects 


are defined in a configuration file, named faces-config.xml. The con- 


Gouaon file must be placed in the WEB-INF subdirectory of the web application’s 
base directory. Here is the configuration file for our application: 


ch24/datetime/WEB-INF/faces-config.xml 


<?xml] 


version="1.0"?> 


<! DOCTYPE faces-config PUBLIC 


teed 


/Sun Microsystems, Inc. L/DTD JavaServer Faces Config 1.0//EN” 
ttp://java.sun. .com/dtd/web- facesconfig_1_0.dtd"> 


confi g> 


<managed-bean> 


1 
2 
3 
4 
5 
6 
7 <faces- 
8 
9 
10 
ll 


<managed-bean-name>dateTime</managed-bean-name> 
<managed-bean-class>java.util.Date</managed-bean-class> 
<managed-bean-scope>request</managed-bean-scope> 


12 </managed-bean> 


13 </face 


s-confi g> 


A value binding links a JSF 
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As you can see, this file defines an object with name dateTime and type 


component Mths n java.util.Date. A new object is constructed with each “request”. 


property. 


The JSF technology 
enables the separation of 
presentation and business 


logic. 


24.3. 


That means, whenever a browser requests the page, a new Date object 

is constructed and attached to the dateTime variable. Because the Date 
constructor constructs an object with the current time, the application always 
shows the millisecond count that was current when the page was requested. 

The value binding expression #{dateTime. time} calls the getTime method on the 
Java object dateTime. (You will see in the next section why the called method is 
getTime and not time.) The getTime method of the Date class returns the number of 
milliseconds between January 1, 1970 and the time at which the Date object was cre- 
ated. The h: outputText tag uses the result of that method call and converts it to text. 

Value bindings support a crucial design principle of the JSF tech- 
nology: the separation of presentation and business logic. 

Here, the presentation logic reters to the user interface of the web 
application: the arrangement of the text, images, buttons, and so on. 
The business logic is the part of the application that is independent of 
the visual presentation. In commercial applications, it contains the rules that are 
used for business decisions: what products to offer, how much to charge, to whom 
to extend credit, and so on. In our example, we simulated the business logic with a 
Date object. 

JSF pages define the presentation logic. Java objects define the business logic. 
The value bindings tie the two together. 

The separation of presentation logic and business logic is very important when 
designing web applications. Some web technologies place the code for the business 
logic right into the web page. However, this quickly turns into a serious problem. 
Programmers are rarely skilled in web design (as you can see from the boring web 
pages in this chapter). Graphic designers don’t usually know much about program- 
ming and find it very challenging to improve web pages that contain a lot of code. 
JSF solves this problem. In JSF, the graphic designer only sees the elements that 
make up the presentation logic. It is easy to take a boring JSF page and make it 
pretty by adding banners, icons, and so on. 


SELF CHECK 


3. What steps are required to add the image of a clock to the datetime application? 
(The clock doesn’t have to show the correct time.) 


4. Does a Swing program automatically separate presentation and business logic? 


Veh iS 


To develop a JSF application, you need a server with a JSF container. We suggest 
that you use the GlassFish application server [1] which has, together with many 
other features that you can ignore, a JSF container and a convenient administration 
interface. 
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To deploy a JSF application, follow these steps: 


1. 
2. 


10. 


Make a separate directory tree for each web application. 


Place JSF pages (such as index. jsp) into the root directory of the application’s 
directory tree. 


. Create a WEB-INF subdirectory in your application directory. 
. Place the faces-config.xm1 file into the WEB-INF subdirectory. 


. If your web application contains Java classes, place them inside a classes sub- 


directory of the wEB-INF directory. Most web applications require Java classes, 
but in our first sample application, we skip this step and make do with the 
Date class from the standard library. 


. Place the file web.xm1 (which is shown below) inside the WEB-INF subdirectory. 


The JSF container needs this file to configure the JSF library. 


. Zip up all application files into a file with extension .war (Web Archive). This 


is easily achieved by running the jar command from the command line, after 
changing to the application directory. For example, 

cd datetime 

jar cvf . > datetime.war 
The period (.) denotes the current directory. The jar command creates an 
archive consisting of all files in all subdirectories of the current directory and 
redirects the output to the file datetime.war. 


. Make sure the application server is started. The application server listens to 


web requests, typically on port 8080. 


. Deploy the application to the application server. With GlassFish, this can be 


achieved either through the administration interface or simply by copying the 
WAR file into a special deployment directory. By default, this is the subdirec- 
tory domains/domain1/autodeploy inside the GlassFish installation directory. 
Point your browser to an URL such as http: //localhost:8080/datetime/ 
index. faces. Note that the URL has a suffix . faces. (The fact that the URL 
suffix .faces is different from the page suffix .jsp is an unfortunate historical 
accident.) 


Figure 7 shows the directory structure for the application. 

It is a bit painful to write all these files by hand, and to put them in the right 
places. There are development tools available that do much of the routine work for 
you—see Figure 8 for an example. For simple applications—such as the ones in this 
chapter—the manual process is certainly feasible. For large applications, you will 
want to use a professional JSF development tool. 


(J datetime 
[% index. jsp 
© (71 WEB-INF 
[5 faces-config.xml 
[*) web.xml 


Figure 7 The Directory Structure of the datetime Application 
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A Tool for Visual JSF Page Design 


ch24/datetime/WEB-INF/web.xml 


<?xml version='"1.0"?> 


<!DOCTYPE web-app PUBLIC 
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" 
"http://java.sun.com/dtd/web-app_2_3.dtd"> 


<web-app> 
<servlet> 
<servlet-name>Faces Servlet</servlet-name> 
<servlet-class>javax.faces.webapp.FacesServlet</servlet-class> 
<load-on-startup>1</load-on-startup> 
</servlet> 


<serv let-mapping> 
<servlet-name>Faces Servlet</servlet-name> 
<url-pattern>*.faces</url-pattern> 
</servlet-mapping> 
</web-app> 
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SELF CHECK 


5. Why does the WAR file need to be deployed to the application server? 
6. Why does the faces-config.xm1 file need to be included in the WAR file? 
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Properties of a software 


A software component is an entity that encapsulates functionality and 


eapencne. ioe can be plugged into a software system without programming. For 
accessed without having example, when we added the dateTime object to the web application, 
to write Java code. we did not write code to construct the object or to call its methods. 


A JavaBean is a class with 


Instead, we specified the object’s behavior in configuration files. 
Some programming languages have explicit support for components, 
but Java does not. Instead, in Java, you use a programming conven- 


a default constructor that .- t1on to implement components. A JavaBean is a Java class that fol- 
exposes properties lows this convention. A JavaBean exposes properties—values of the 
through its get andset | component that can be accessed without programming. 


methods. 


Just about any Java class can be a JavaBean—there are only two 
requirements. 


° A JavaBean must have a public constructor with no parameters. 


¢ A JavaBean must have methods for accessing the component properties that fol- 
low the get/set naming convention. For example, to get or set the time property 
of a Date object, the methods must be called getTime and setTime. 


In general, if the name of the property is propertyName, and its type is Type, then 
the associated methods must be of the form 


public Type getPropertyName() 
public void setPropertyName(Type newValue) 


This is, of course, a convention that we have used for most accessor and mutator 
methods. There is one exception—the accessor of a boolean property can use an is 
prefix, for example 


public boolean isShopping() 


Note that the name of a property starts with a lowercase letter (such as shopping), 
but the corresponding methods have an uppercase letter (isShopping). The only 
exception is that property names can be all capitals, such as ID or URL, with corre- 
sponding methods getID or setURL. 

If a property has only a get method, then it is a read-only property. If it has only 
a set method, then it is a write-only property. 

A JavaBean can have additional methods, but they are not connected with 
properties. 

Finally, many programmers follow the additional convention that the name of a 
bean class should end in Bean, but this is not a requirement. 
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Here 1s a simple example of a bean class: 


public class UserBean 


{ 
// Required default constructor 
public UserBean() { ... } 
// creditCard property 
public String getCreditCard() { .. . } 
public void setCreditCard(String newValue) { .. . } 


// shopping property 
public boolean isShopping®) { . . } 
public void setShopping (boolean fewvalde) a 


// Other methods 
// ) fnceanee fields 


} 


This bean has two properties: creditCard and shopping. 

You should not make any assumptions about the internal representation of prop- 
erties in the bean class. The bean class may simply have an instance field for every 
property: 

private String creditCard; 

private boolean shopping; 


On the other hand, perhaps the bean class stores the credit card state in a database, 
so that the get and set methods actually contain database operations. Alternatively, 
the isShopping method might compute the property value: 


public boolean isShopping() { return shoppingCart != null; }$ 


To use a bean in a JSF page, define it in the faces-config.xm1 file. For example, you 
can define a bean with the following directive: 


<managed-bean> 
<managed-bean-name>user</managed-bean-name> 
<managed-bean-class>bigjava.UserBean</managed-bean-class> 
<managed-bean-scope>session</managed-bean-scope> 
</managed-bean> 


This directive invokes the default constructor of the UserBean class in the bigjava 
package to make an object with the name user. Recall that every bean must have a 
detault constructor. 

The bean is called a managed bean because the JSF container man- 


Abean with session scope age its lifetime. If the scope has been set to session, then the bean 


is available for multiple stays alive during multiple requests from the same browser. This is 
requests by the same the behavior that you want in most web applications. However, in 
browser. the example of the preceding section, we specified request scope 


because we wanted a new Date object for each connection. 
There is also an application scope for a anh that stays alive for the entire web 
application and that is shared among different users. In contrast, if multiple users 
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are simultaneously accessing a JSF application, each of them has a separate set of 
beans with session scope. 

Once the bean has been defined, you can access its properties in value bindings, 
such as 


<h:outputText value="#{user.creditCard}"/> 


You specify the name of the property, not the name of the get or set methods, 
which is convenient for input tags. For example, the tag 


<h:inputText value="4{user.creditCard}"/> 


first calls getCreditCard to display the current value of the property to the user. The 
user can then make changes to the number. When the user submits the form, the 
setCreditCard method is called to store the edited property value in the bean. 

Let's put these concepts to work in an actual JSF page. Suppose we want to dis- 
play the current time, not the number of milliseconds since January 1, 1970. 
Because the default time computation uses the time zone at the server location, 3 it is 
not very useful if the user is in another time zone. We will prompt for the city in 
which the user is located, and then display the time in the user’s time zone (see 
Figure 9). 

The Java library contains a convenient TimeZone class that knows about time 
zones across the world. A time zone is identified by a string such as "America/ 
Los_Angeles" or "Asia/Tokyo". The static method getAvailableIDs returns a string 
array containing all [Ds: 


String[] ids = TimeZone.getAvailableIDs(); 


* |The timezone application - Firefox > 


File Edit View History Bookmarks Tools Help 


<r CE | httpiflocalhost:sogojtimezonefindexfaces || 


The current date and time in Los Angeles is: 3:40:22 PM 


DATION MAP IB TPES bP Ae aL NAA SAN TERT DN TCP 


Set time zone: [Tokyo 
Submit | ~ 


* * |The” timezone - application - Firefox Ses ea ead ea 2 |B 4 


File Edit View History Bookmarks Tools Help 


@-: ‘Ss is] 1 http localhost: 8080/timezone/index. faces” lel Be] 


The current date and time in Tokyo is: 8:41:02 AM 


set time zone: | 


Submit | 


Figure 9 The timezone Application 
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There are several hundred time zone IDs. (We are using time zones in this exam- 
ple because the TimeZone class gives us an interesting data source with lots of data. 
Later in this chapter, you will see how to access data from a database, but of course 
that’s more complex.) 

The static getTimeZone method returns a TimeZone object for a given ID string: 


String id = "America/Los_Angeles"; 
TimeZone zone = TimeZone.getTimeZone(id) ; 


Once you have a TimeZone object, you can use it in conjunction with a DateFormat 
object to get a time string in that time zone. 


DateFormat timeFormatter = DateFormat.getTimeInstance() ; 
timeFormatter.setTimeZone(zone) ; 

Date now = new Date(); 

// Suppose the server is in New York, and it’s noon there 
System.out.printIln(timeFormatter. format (now) ); 

// Prints 9:00:00 AM 


Of course, we don’t expect the user to know about time zone ID strings, such as 
"America/Los_Angeles". Instead, we assume that the user will simply enter the city 
name. The time zone bean will check whether that string, with spaces replaced by 
underscores, appears at the end of one of the valid time zone IDs. 

Here is the code for the bean class. The class must be placed inside the WEB-INF/ 
classes directory. Many application servers require that all classes be contained in a 
package. We place the classes of our sample examples inside the bigjava package. 
Therefore, the class is actually contained in the WEB-INF/classes/bigjava directory. 


ch24/timezone/WEB-INF/classes/bigjava/TimeZoneBean.java 
package bigjava; 
import java.text.DateFormat; 


import java.util.Date; 
import java.util.TimeZone; 


and city. 


public class TimeZoneBean 


1 
2 
3 
4 
5 
6 
7 ; 
8 This bean formats the local time of day for a given date 
9 
10 
11 
12 


{ 
13 
14 Initializes the formatter. 
15 es 
16 public TimeZoneBean() 
17 { 
18 timeFormatter = DateFormat.getTimeInstance() ; 


19 } 
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jr 
Setter for city property. . 
@param aCity the city for which to report the local time 


* / 
public void setCity(String aCity) 
{ 
city = aCity; 
zone = getTimeZone(city); 
} 


Getter for city property. 
@return the city for which to report the local time 


+ / 
public String getCity( 
7 


} 
ys 


Read-only time property. 
@return the formatted time 


return city; 


vs i 
public String getTime() 


{ 
if (zone == null) return "not available"; 
timeFormatter.setTimeZone(zone) ; 
Date time = new Date(); 
String timeString = timeFormatter.format(time) ; 
return timeString; 

} 

jist 


Looks up the time zone for a city. 
@param aCity the city for which to find the time zone 
@return the time zone or null if no match is found 
ad 
private static TimeZone getTimeZone(String aCity) 
{ 
String[] ids = TimeZone.getAvailableIDs(); 
for Cint 71 = 0; 1 < ids.length; i++) 
if (timeZoneIDmatch(Cids[i], aCity)) 

return TimeZone.getTimeZone(Cids[i]); 

return null; 


Checks whether a time zone ID matches a city. 
@param id the time zone ID (e.g., "America/Los_Angeles") 
@param aCity the city to match (e.g., "Los Angeles") 
@return true if the ID and city match 
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be private static boolean timeZoneIDmatch(String id, String aCity) 
{ 

75 String idCity = id.substring(id.indexOf('/') + 1); 

76 return idCity.replace('_', ' ‘).equals(aCity) ; 

77 } 

78 

79 private DateFormat timeFormatter; 

80 private String city; 

81 private TimeZone zone; 

82 } 


The bean is defined in the faces-config.xm1 file. Note the managed-property tag that 
sets the city property to an initial value "Los Angeles". 


ch24/timezone/WEB-INF/faces-config.xml 


<?xml version='1.0"?> 


<!DOCTYPE faces-config PUBLIC 
"_7//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.0//EN" 
"http: //java.sun.com/dtd/web-facesconfig_1_0.dtd"> 


<managed-bean> 
<managed-bean-name>zone</managed-bean-name> 
<managed-bean-class>bigjava. TimeZoneBean</managed-bean-class> 
<managed-bean-scope>session</managed-bean-scope> 


1 
2 
3 
4 
5 
6 
7 <faces-config> 
8 
9 
10 
11 


12 <managed-property> 

13 <property-name>city</property-name> 
14 <value>Los Angeles</value> 

15 </managed-property> 

16 </managed-bean> 


17 </faces-config> 


Here is the JSF page that invokes the time zone bean. There are two h:outputText 
tags that display the city and time properties. These tags invoke the getCity and 
getTime methods of the bean class. The h:inputText tag produces an input field. 
Finally, the h: commandButton tag produces a button. When the user clicks the button, 
the browser sends the form values (that is, the contents of the input field) back to 
the web application. The web application calls the setCity method on the bean 
because the input field has a #{zone.city} value binding. Then the web application 
redisplays the form. 


ch24/timezone/index.jsp 
lL <html> 


2 <%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %> 
3 <%@ taglib uri="http://java.sun.com/jsf/htm1" prefix="h" %> 
4 

5 <f:view> 

6 <head> 

7 


<title>The timezone application</title> 
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8 </head> 

9 <body> 
10 <h: form> 

ll <p> 

12 The current date and time in 

13 <h:outputText value="#{zone.city}"/> 
14 1s: 

15 <h:outputText value="#{zone.time}"/> 
16 </p> 

17 <p> 

18 Set time zone: 

19 <h:inputText value="#{zone.city}"/> 
20 </p> 
21 <p> 

22 <h:commandButton value="Submit"/> 
Z3 </p> 
24 </h:form> 
25 </body> 
26 </f:view> 

27 = </htmI> 


Figure 10 shows the directory structure of the timezone application. The web.xml file 
is unchanged from the datetime application. 

This example demonstrates the separation of the presentation from the Java code. 
The user interface (that is, the text, input field, and button) are specihed in the JSF 
page. The Java code is contained in the bean class. A graphic designer can improve 
the look of the page by editing the HTML document to change the layout, add 
images, and so on, without having to do any programming. Conversely, a program- 
mer can modify the code of the bean class without doing any web design. 


J timezone 
[§ index. jsp 
© (J WEB-INF 
y faces—config. xml 
[4 web.xml 
® Cl classes 
? Cl bigjava 


[4 TirmeZoneBean. java 


Figure 10 ~The Directory Structure of the timezone Application 


SELF CHECK 


7. Is the Random class a Java bean? 


8. What work does the setCity method of the TimeZoneBean do besides setting the 
city instance field? 


9. When you start the timezone application for the first time, why does the input 
field contain the string "Los Angeles"? 
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COMMON ERROR 24.1 
Fussy JSF Syntax 


It is very easy to make errors in the JSF syntax, because it is a mixture of HTML and JSF- 
specific tags. Also, because the JSF processing step is hidden from the programmer, you 
don’t get good error messages. Here are some of the most common errors: 


° Forgetting the / before a closing angle bracket, such as <h:outputText . . . />. The JSF 
tags use the XML syntax, and a closing / is required (unless you supply a separate closing 
tag </h:outputText>). 

e Letter case errors, such as h:outputtext instead of h:outputText. HTML 1s not case- 
sensitive, but the JSF tags are. 

° Forgetting the h: or f: prefixes. A tag such as <outputText . . . />1s simply passed on 
to the browser. The browser has no idea how to display it and ignores it. 

° Forgetting quotation marks for attribute values. In HTML it is OK to omit these quota- 
tion marks, but the JSF tags follow the stricter XML syntax. For example, <h:outputText 
value=#{dateTime.time}/> is an error. 


° Forgetting the #{. . .} delimiters around value bindings. For example, <h:outputText 
value="dateTime.time"/> simply produces a string dateTime. time in the output. 


How To 24.1 


Designing a Bean 


A bean is just a regular Java class, with two special characteristics. 
e The bean must have a default constructor. 
e Methods of the form 

Type getPropertyName() 

void setPropertyName (Type x) 

define properties that can be accessed from JSF pages. 


Here are step-by-step instructions for designing a bean class. 
Step 1. Decide on the responsibility of the bean. 


When designing a JSF application, it is tempting to stuff all code into a single bean class. 
Some development environments even encourage this approach. However, from a software 
engineering perspective, it is best to come up with different beans for different responsibilt- 
ties. For example, a shopping application might have a UserBean to describe the current user, 
a SiteBean to describe how the user visits the shopping site, and a ShoppingCartBean that 
holds the items that the user is purchasing. 


Step 2. Discover the properties that the bean should expose. 


A property is an entity that you want to access or modify from your JSF pages. For example, 
a UserBean might have properties FirstName, lastName, and password. 
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Sometimes, you have to resort to a bit of trickery. For example, consider adding an item 
to the shopping cart. You could use a property items, but it would be cumbersome to access 
all items in a JSF page and then set items to a new collection that contains one additional ele- 
ment. Instead, you can design a property addedItem. When that property is set, the 
setAddedItem method of your bean adds its value to the collection of items. 


Step 3 Settle on the type and access permissions for each property. 


Properties that are used in h:outputText tags can be read-only. Properties that are used in 
h:inputText and other input tags must have read-write access. 


Step 4 Implement the default constructor. 


It initializes any fields that are reused whenever the bean’s computation is executed. Exam- 
ples are formatters, random number generators, and so on. 


Step 5 Implement the get and set methods for all properties. 


Most get and set methods simply get or set an instance field. However, you can carry out 
arbitrary computations in these methods if it is convenient. For example, a get method may 
retrieve information from a database instead of an instance field. 


Step 6 Supply any needed helper methods. 


Your bean can have methods that are not property getters and setters. For example, the Time- 
ZoneBean has helper methods to look up the time zone for a city. 


ADVANCED TOPIC 24.2 


Session State and Cookies 


You may recall from Chapter 21 that HTTP is a stateless protocol. A browser sends a request 
to a web server. The web server sends the reply and then disconnects. This is different from 
other protocols, such as POP, where the mail client logs into the mail server and stays con- 
nected until it has retrieved all e-mail messages. In contrast, a browser makes a new connec- 
tion to the web server for each web page, and the web server has no way of knowing that 
those connections originate from the same browser. This makes it difficult to implement web 
applications. For example, in a shopping application, it is essential to track which requests 
came from a particular shopper. 

Cookies were invented to overcome this restriction. A cookie consists of a small string 
that the web server sends to a browser, and that the browser sends back to the same server 
with all further requests. That way, the server can tie the stream of requests together. The JSF 
container matches up the cookies with the beans that have session scope. When a browser 
request contains a cookie, the value bindings in the JSF page refer to the matching beans. 

You may have heard some privacy advocates complaining about cookies. Cookies are not 
inherently evil. When used to establish a session or to remember login information, they can 
make web applications more user-friendly. But when cookies are used to track your identity 
while you surf the Web, there can be privacy concerns. For example, Figure 11 shows some 
of the cookies that my browser held on a particular day. I have no recollection of visiting the 
advertising sites, so it is a bit disconcerting to see that my browser communicated with them. 
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Some people turn off cookies, and then web applications need to use another scheme to 
establish a session, typically by embedding a session identifier in the request URL or a 
hidden field of a form. The JSF session mechanism automatically switches to URLs with ses- 
sion identifiers if the client browser doesn’t support cookies. 


i) Cookies 


Search: 


The following cookies are stored on your computer: 


CookieName 


_i marketingpilgrim.com 
# | > media. adrevalver.com 
# | > mediaplex.com 


* | metrics .adobe.com 
+ | > metropes.com 
+ | > microsoft.com 


Name: _utmz | | | 

| Content: 153050405,1163906620.1, Lutmecn=(referralljutmesr=cafeconlec 

— Bornain: . marketingpilgrim.com | 

Path: / 

| Send For: Any type of connection | 
Figure 11 |_ Expires: 07/17/2007 05:16:59AM 


Viewing the Cookies | Remove Cookie | ‘Ye Remove All Cookies | 
in a Browser UHI 0}. UjT CH}... 


“ : = QBS Ne oo i a a re} ent. RS RST Oe ee EE ae RES IRS BE Ag ae RL el Oe ae 
 & . SF = ant teeny Com ae aes a peace One MESON _ a Soa tre Og ee ae Ra ST RO Ie PP sears es hkl aie ae SI eRe Og Stecr ag Wop tae eas ERG eae Mate) 
Ai aod Redo ee a a hat Sata wes Ta tpea gaia Spier rece eis ee ty gee eee Oe ee 6 IBIAS 
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In this section, you will see the most useful user interface components that you can 

place on a JSF form. Table 1 shows a summary. For a comprehensive discussion of 
all JSF components, see [2]. 

| Each component has a value attribute that allows you to connect the 


The value attribute ofan = component value with a bean property, for example 


input component denotes — 
‘the value that the user <h:inputSecret value="#{user.password}"/> 
supplies. === The h:inputTextArea component has attributes to specify the rows 
eS _ and columns, such as 
<h:inputTextArea value="#{user.comment}" rows="10" cols="40"/> 


The radio button and checkbox groups allow you to specify horizontal or vertical 
layout: 


<h:selectOneRadio value="#{burger.topping}" layout="lineDirection’> 
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Table 1 Common JSF Components 


Common 


Component SF Ta : Example 
P J 5 Attributes P 
Text Field HEINDEEH EX value [3345678901234567800 
Password h:inputSecret value po 
Field ES ae 
Text Area h:inputTextArea value <a 
rows line two 
cols jline three 
Radio h:selectOneRadio value 
Button h:selectManyRadio layout *™ Cheese ® Pickle © Mustard “ Lettuce “ Onions 
Group 
Checkbox h:selectOneCheckbox value Sect ees 
h:selectManyCheckbox value ace ack aaa oe ai ; 
ee : layout ~ Cheese | Pickle IY Mustard! Lettuce [ Onions 
roup 
Menu h:selectOneMenu value 
h:selectManyMenu 
Image h:graphicImage value 
Submit h:commandButton value ; 
Button action _press me | 


In European languages, lineDirection means horizontal and pageDirection means 
vertical. However, in some languages, lines are written top-to-bottom, and the 
meanings are reversed. 

Button groups and menus are more complex than the other user interface com- 
ponents. They require you to specify two properties: 


e the collection of possible choices 
e the actual choice 
The value attribute of the component specifies the actual choice to be 


displayed. The collection of possible choices is defined by a nested 
f:selectItems tag, like this: 


Use an f:selectItems 
tag to specify all choices 
for a component that 
allows selection from a list <h:selectOneRadio value="#{creditCard.expirati onMonth}" 
of choices. layout="pageDirection"> 
<f:selectItems value="#{creditCard.monthChoices}"/> 
</h:selectOneRadio> 
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Here, the monthChoices property must have a type that can describe a list of choices. 
There are several types that you can use, but the easiest—and the only one that we 
will discuss—is a Map. The keys of the map are the /abels—the strings that are dis- 
played next to each choice. The corresponding map values are the label values—the 
values that correspond to the selection. For example, a choice map for months 
would map January to 1, February to 2, and so on: 


public class CreditCardBean 


{ 
public Map<String, Integer> getMonthChoices() 
{ 
Map<String, Integer> choices = new LinkedHashMap<String, Integer>(); 
choices.putC"January", 1); 
choices.put("February", 2); 
return choices; 
} 
} 


Here, we use a LinkedHashMap because we want to visit entries in the order in which 
they are inserted. This is more useful than a HashMap, which would visit the labels in 
random order or a TreeMap, which would visit them in alphabetical order (starting 
with April!). 

The type of the value property of the component must match the type of the 
map value. For example, creditCard.expirationMonth must be an integer, not a 
string. If multiple selections are allowed, the type of the value property must be a 
list or array of matching types. For example, if one could choose multiple months, a 
selectManyRadio component would have a value property with a type such as int[] 
or ArrayList<Integer>. 

We will discuss submit buttons in detail in the following section. 


SELF CHECK 


10. Which JSF components can be used to give a user a choice between “AM/PM” 
and “military” time? 


11. How would you supply a set of choices for a credit card expiration year toa 
h:selectOneMenu component? 


fess Sa SPS Se i reed ERE Pe eR a 


In most web applications, users will want to move between different pages. For 
example, a shopping application might have a login page, a page to show products 
for sale, and a checkout page that shows the shopping cart. In this section, you will 
learn how to enable users to navigate from one page to another. 

Consider an enhancement of our timezone program. We start with a page that 
prompts the user to enter the name of a city. When the user clicks the “Submit” 
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® Tokyo: 10:37:23 4M 
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Figure 12 Navigating Between Pages 


button, a new page appears. The next page is either the page with the time display or 
an error page if no time zone is available for the city (see Figure 12). The JSF con- 
tainer needs to determine which page to show next. 
Each button has an outcome, a string that is used to look up the 
The outcome string ofan — next page. In many situations, the next page depends on the result of 
action determines the next = s95me computation. In our example, we need different outcomes 


page that the JSF cOmamel, depending on the city that the user entered. To achieve this flexibil- 
sends to the browser. ity, you specify a method binding as the action attribute: 


<h:commandButton value="Submit" action="#{zone.addCity}"/> 


Aciethod winding A method binding consists of the name of a bean and the name of a 
Species bean anda method. When the form is submitted, the JSF engine calls 
methodcthat shouldbe zone.addCity(). The addcity method returns a string: 
invoked on the bean. public class TimeZoneBean 
{ 
public String addCity() 
: 
1f (zone == null) return "unavailable"; 
// Add the city 
return "available"; 
t 


} 


If the next page does not depend on a computation, then you set the action 
attribute of the button to a fixed outcome string, like this: 


<h:commandButton value="Back" action="back"/> 
A navigation rule mae The faces-config.xm1 file contains a navigation rule that maps out- 


outcome strings to JSF come strings to pages: 


pages. | | <faces-config> 
, . <navigation-rule> 
<navigation-case> 
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<from-outcome>avai lable</from-outcome> 
<to-view-id>/next. jsp</to-view-1d> 
</navigation-case> 
<navigation-case> 
<from-outcome>unavai lable</from-outcome> 
<to-view-id>/error. jsp</to-view-1id> 
</navigation-case> 
<navigation-case> 
<from-outcome>back</from-outcome> 
<to-view-id>/index. jsp</to-view-1id> 
</navigation-case> 
</navigation-rule> 


</faces-config> 


For example, if the addCity method returns the string "unavailable", then the page 
error.jsp is displayed. 

If a button has no action attribute, or if the action outcome is not listed in the 
navigation rules, then the current page is redisplayed. 


SELF CHECK 


12. What tag would you need to add to error.jsp so that the user can click on a 
button labeled “Help” and see help.jsp? What other changes do you need to 
make to the web application? 


13. Which page would be displayed if the addcity method returned nu11? 


How To 24.2 


Building a Web Application 


Step 1 On separate sheets of paper, sketch a screen for each web page of the application. 


Start out with the initial screen, often a login screen. On each screen will be one or more but- 
tons that post data to the server and switch to another page (or maybe the same page with 
more information added). Be sure to include error screens for invalid inputs. 


Step 2 Draw a navigation diagram similar to the one in Figure 12. 
For each page, draw an arrow to its successor page and label it with an outcome string. 
Step 3. On each web page, mark the static and dynamic parts. 


The static parts always stay the same (such as titles, logos, instructions, and so on). The 
dynamic parts change according to user input. 


Step 4 Design beans to supply the dynamically generated output and to hold the user 
input. 


See How To 24.1 for more information on designing beans. 
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Step 5 Analyze the navigation behavior and supply action methods. 


In JSE, navigation between pages 1s defined by navigation rules that are triggered by outcome 
strings. If a button always selects a fixed successor page, use a fixed action string. Otherwise, 
implement an action method that determines the successor page. 


Step 6 Code the JSF pages. 
You can use a text editor, a JSF-aware HTML editor, or a JSF development tool. 
Step 7 Implement the Java code for the beans and compile it. 


You need get and set methods for the bean properties as well as action methods for the com- 
mand buttons that require dynamic navigation. 


Step 8 Define beans and navigation rules in the configuration file. 
Add navigation-case and managed-bean tags to the faces-config.xm1 file. 
Step 9 Deploy your application. 


Place the JSF files and any necessary images into the web application directory, the web. xm1 
and faces-config.xm1 files into the WEB-INF subdirectory, and the class files into the wEB- 
INF/classes subdirectory. 
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AseAV estes Dbl cations. In the final JSF example, you will see a web application with a very 


Shas sep apareticrs tor common structure. In this example, we will use a database for infor- 
presentation, business .-—~—-—SsMation storage. We will enhance the time zone example by storing 
logic, and data storage. additional cities that are not known to the TimeZone class in a data- 


base. Such an application is called a three-tier application because it 
consists of three separate layers or tiers (see Figure 13): 


° The presentation tier: the web browser 
e The “business logic” tier: the JSF container, the JSF pages, and the JavaBeans 
e The storage tier: the database 


Internet 


Presentation Tier Middle Tier Storage Tier 
(Browser) (Business Logic) 


Figure 13° Three-Tier Architecture 
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Local Area 
Network .. 


Client Server 
(Presentation and (Database) 
Business Logic) 


Figure 14 Two-Tier Client-Server Architecture 


Contrast the three-tier architecture with the more traditional client-server or two- 
tier architecture that you saw in the database programs of Chapter 22. In that archi- 
tecture, one of the tiers is the database server, which is accessed by multiple client 
programs on desktops. Each client program has a presentation layer—usually with 
a specially programmed graphical user interface—and business logic code. (See 
Figure 14.) When the business logic changes, a new client program must be 
distributed over all desktops. In contrast, in a three-tier application, the business 
logic resides on a server. When the logic changes, the server code is updated, while 
the presentation tier—the browser—remains unchanged. That is much simpler to 
manage than updating multiple desktops. 

In our example, we will have a single database table, CityZone, with city and time 
zone names (see Figure 15). 


ch24/multizone/sql/CityZone.sql 


CREATE TABLE CityZone (City CHAR(40), Zone CHAR(40)) 

INSERT INTO CityZone VALUES ('San Francisco’, 'America/Los_Angeles' ) 
INSERT INTO CityZone VALUES ('Kaoshiung', 'Asia/Taipei') 

SELECT * FROM CityZone 


ft W Nf 


If the TimeZoneBean can’t find the city among the standard time zone IDs, it makes a 
database query: 


SELECT Zone FROM CityZone WHERE City = the requested city 


If there is a matching entry in the database, that time zone is returned. 


CityZone 
City Zone 


San Francisco America/Los_Angeles 


Kaoshiung Asia/Taipei 


Figure 15 The CityZone Table 
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You define data sources in | 
the JSF container and use 
resource annotations to 
initialize them. 
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To query the database, the bean needs a Connection object. In Chapter 22, we 
used the static getConnection method of the DriverManager class to obtain a database 
connection. However, JSF containers have a better mechanism for configuring a 
database in one central location so that multiple web applications can access it. 

The GlassFish application server includes the Derby database. It has a predefined 
data source with the resource name jdbc/__default. In your bean code, you define 
an instance field of type DataSource and tag it with a @Resource annotation, like this: 


@Resource(name="jdbc/__ default") 
private DataSource source; 


You can use the administration interface of GlassFish to define other data sources. 
When the application server loads the web application, it automatically initializes 
this field. Whenever you need a database connection, call 


Connection conn = source.getConnection(); 
try 


Use the connection 


} 
finally 
{ 
conn.close(); 
} 


The application server provides an additional service: it pools data- 
base connections. When a pooled connection is closed, it is not phys- 
ically terminated but instead returned to a queue and given out again 
to another caller of the getConnection method. Pooling avoids the 
overhead of creating new database connections. In a web application, 
it would be particularly inefficient to connect to the database with 
every web request. Connection pooling is completely automatic. 

In order to make the application more interesting, we enhanced the TimeZoneBean 
so that it manages a list of cities. You can add cities to the list and remove a selected 
city (see Figure 16). You will find the code for this web application at the end of 
this section. Figure 17 shows the directory structure of the application. 


* |The multizo ne applica’ tion - Fire: fox iS ee ee eas ay Gee eee | ad 
File Edit View History Bookmarks Tools Help 


@- © [LI httpyjlocalhost:8080/multizonejindexfaces + [| 


© Berlin: 2:38:46 AM 
‘* Buenos Aires: 10:38:46 PM 
* Los Angeles: 5:38:46 PM 

® Tokyo: 10:38:45 AM 


Remove selected | Add another | 


Figure 16 The multizone Application Shows a List of Cities 
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C3 multizone 
LS errar.jsp 
LY index. jsp 
[SY nextjsp 
@ Co Wes-INF 
[S faces-contig. xml 
CS web.xml 
@ Clclasses 
® Co bigjave 


CS TimeZoneBean. java 


Figure 17 The Directory Structure of the multizone Application 


You have now seen how to use the JavaServer Faces technology to build web 
applications. JSF takes care of low-level details so that you don’t have to think 
about HTML forms and the HTTP protocol. Instead, you can focus on the presen- 
tation and business logic of your application. 


ch24/multizone/index.jsp 
lL <html> 


2 <%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %> 
3 <%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %> 
4 

5 <f:view> 

6 <head> 

7 <title>The multizone application</title> 

8 </head> 

9 <body> 
10 <h: form> 
11 <p> 
12 Enter city: 
13 <h:inputText value="#{zone.cityToAdd}"/> 
14 </p> 
15 <p> 
16 <h:commandButton value="Submit" 
17 action="#{zone.addCity}"/> 
18 </p> 
19 </h:form> 
20 </body> 
21 </f:view> 
22 </html> 


ch24/multizone/next.jsp 


lL <html> 

2 <%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %> 
3 <%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %> 
4 

5 <f:view> 

6 <head> 

/ <title>The multizone application</title> 

8 </head> 


1038 


CHAPTER 24 #8 Web Applications 


9 <body> 
10 <h: form 
11 <p> 
12 <h:selectOneRadio value="#{zone.cityToRemove}" 
13 layout="pageDirection"> 
14 <f:selectItems value="#{zone.citiesAndTimes}"/> 
15 </h:selectOneRadio> 
16 </p> 
17 <p> 
18 <h:commandButton value="Remove selected" 
19 action="#{zone. removeCity}"/> 
20 <h:commandButton value="Add another" action="back"/> 
21 </p> 
ZZ </h:form> 
LS </body> 
24 </f:view> 
25 </htmI> 


ch24/multizone/error.jsp 


lL <html> 
<“@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %> 
<4@ taglib uri="http://java.sun.com/jsf/htm|" prefix="h" %> 


2 
3 
4 
5 <f: view 
6 
7 
8 


<head> 
<title>The multizone application</title> 
</head> 
<body> 
10 <h: form> 
11 <p> 
12 Sorry, no information is available for 
13 <h:outputText value="#{zone.cityToAdd}"/> 
14 </p> 
15 <p> 
16 <h:commandButton value="Back" action="back"/> 
17 </p> 
18 </h: form> 
19 </body> 
20 </f:view> 
21 </htmI> 


ch24/multizone/WEB-INF/classes/bigjava/TimeZoneBean.java 


1 package bigjava; 

2 

3 import java.sql.Connection; 

4 import java.sql.PreparedStatement; 
5 =import java.sql.ResultSet; 

6 import java.sql.SQLException; 

/ import java.text.DateFormat; 

8 import java.util.ArrayList; 

9 import java.util.Date; 
10 import java.util.Map; 
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12 
LS 
14 
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16 
17 
18 
19 
20 
21 
rw 
ao 
24 
25 
26 
ae 
28 
29 
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4 
33 


# A Three-Tier Application 


import java.util.TimeZone; 
import java.util.TreeMap; 

import java.util. logging.Logger; 
import javax.annotation.Resource 
import javax.sql.DataSource; 


joe 
This bean formats the local time of day for a given date 
and city. 
7 
public class TimeZoneBean 
1 
/* % —— 
Initializes the formatter. 
at 
public TimeZoneBean() 
{ 


timeFormatter = DateFormat.getTimeInstanceQ() ; 
cities = new ArrayList<String>Q ; 


“Sevier for cityToAdd property. 

@param city the city to add to the list of cities 
* / 
public void setCityToAdd(String city) 


{ 
cityToAdd = city; 


Getter for cityToAdd eee 

@return the city to add to the list of cities 
% / 

public String getCityToAdd() 


{ 
return cityToAdd; 


ate ole 


Gaur cityToRemove ‘aoa hae 
@param city the city to remove from the list of cities 


public void setCityToRemove(String city) 
{ 


} 


cityToRemove = city; 


omebege cityToRemove property. 

@return the city to remove from the list of cities 
* / 
public String getCityToRemove() 
{ 


return citylToRemove 
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Read-only citiesAndTimes property. 


@return a map containing the cities and formatted times 


public Map<String, String> getCitiesAndTimes() 


{ 


Date time = new Date(); 
Map<String, String> result = new TreeMap<String, String>Q; 
for (int i = 0; 7 < cities.size(): i++) 
{ 
String city = cities.get(i); 
String label = city + ": "; 
TimeZone zone = getTimeZone(city) ; 
if (zone != null) 
{ 
timeFormatter.setTimeZone(zone) ; 
String timeString = timeFormatter.format(time) ; 
label = label + timeString; 
} 
else 
label = label + “unavailable”; 
result.putClabel, city); 


} 


return result; 


Action for adding a city. 


@return “available” if time zone information is available for the city, 
“unavai lable" otherwise 


* / 
public String addCity() 


i 


{ 


TimeZone zone = getTimeZone(cityToAdd) ; 
if (zone == null) return "unavailable": 
cities.add(cityToAdd) ; 

cityToRemove = cityToAdd; 

cityToAdd = ""; 

return "available": 


Action for removing a city. 
@return null if there are more cities to remove, “back” otherwise 


public String removeCity() 


cities.remove(cityToRemove) ; 
if (cities.sizeQ > 09) return null; 
else return "back"; 
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Looks up the time zone for a city. 
@param city the city for which to find the time zone 
@return the time zone or nu11 if no match is found 


private TimeZone getTimeZone(String city) 


{ 


} 


String[] ids = TimeZone.getAvailableIDsQ); 
for Gnt 1 =0; 1 < ids. length; 14++) 
if CtimeZoneIDmatch(ids[i], city)) 
return TimeZone.getTimeZone(ids[i]); 
try 
if 
String id = getZoneNameFromDB (city) ; 
if Cid != null) 
return TimeZone.getTimeZone(id) ; 


catch CException exception) 


‘ 


Logger.global.infoC'Caught in TimeZone.getTimeZone: 


+ exception); 
} 


return null; 


private String getZoneNameFromDB(String city) 


{ 


} 


throws SQLException 


if Csource == null) 
{ 
Logger.global.infoC'No database connection"); 
return null; 
, 
Connection conn = source.getConnection() ; 
try 
{ 
PreparedStatement stat = conn.prepareStatement( 
"SELECT Zone FROM CityZone WHERE City=?"); 
Stat.setStringd, city); 
ResultSet result = stat.executeQuery() ; 
if Cresult.nextQ) 
return result.getString(.).trim; 
else 
return null; 


} 
finally 
{ 
conn.close(); 
} 
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174 
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177 
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Checks whether a time zone ID matches a city. 
@param id the time zone ID (e.g., “America/Los_Angeles") 
@param city the city to match (e.g., "Los Angeles") 
@return true if the ID and city match 
7 
private static boolean timeZoneIDmatch(String id, String city) 
q 
String idCity = id.substring(id.indexOfC'/') + 1); 
return idCity.replace('_', ‘ ‘').equals(city); 
- 


@Resource(name="jdbc/__ default") 
private DataSource source; 


private DateFormat timeFormatter; 
private ArrayList<String> cities; 
private String cityToAdd; 

private String cityToRemove; 


} 


ch24/multizone/WEB-INF/faces-config.xml 


<?xml version="1.0"?> 


<!DOCTYPE faces-config PUBLIC 
"-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.0//EN" 
“"http://java.sun.com/dtd/web-facesconfig_1_0.dtd"> 


<faces-config> 
<navigation-rule> 
<navigation-case> 
<from-outcome>avai lable</from-outcome> 
<to-view-id>/next.jsp</to-view-id> 
</navigation-case> 
<navigation-case> 
<from-outcome>unavai lable</from-outcome> 
<to-view-id>/error.jsp</to-view-1d> 
</navigation-case> 
<navigation-case> 
<from-outcome>back</from-outcome> 
<to-view-id>/index.jsp</to-view-id> 
</navigation-case> 
</navigation-rule> 
<managed-bean> 
<managed-bean-name>zone</managed-bean-name> 
<managed-bean-class>bigjava.TimeZoneBean</managed-bean-class> 
<managed-bean-scope>session</managed-bean-scope> 
</managed-bean> 
</faces-config> 
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SELF CHECK 


14. Why don’t we just keep a database connection as an instance field in the 
TimeZoneBean? 


15. Why does the removeCity method of the TimeZoneBean return null or "back", 
depending on the size of the cities field? 


RANDOM FACT 24.1 
Cataloging Your Necktie Collection 


People and companies use computers to organize just about every aspect of daily life. On the 
whole, computers are tremendously good for collecting and analyzing data. In fact, the 
power offered by computers and their software makes them seductive solutions for just 
about any organizational problem. It is easy to lose sight of the fact that using a computer 1s 
not always the best solution to a problem. 

In 1983, the author John Bear wrote about a person who had come up with a novel use for 
the personal computers that had recently become available. That person cataloged his necktie 
collection, putting descriptions of the ties into a database and generating reports that listed 
them by color, price, or style. We can hope he had another use to justify the purchase of a 
piece of equipment worth several thousand dollars, but that particular application was so 
dear to his heart that he wanted the world to know about it. Perhaps not surprisingly, few 
other computer users shared that excitement, and you don’t find the shelves of your local 
software store lined with necktie-cataloging software. 

The phenomenon of using technology for its own sake is quite widespread. In the “Inter- 
net bubble” of 2000, hundreds of companies were founded on the premise that the Internet 
made it technologically possible to order items such as groceries and pet food from a home 
computer, and therefore the traditional stores would be replaced by web stores. However, 
technological feasibility did not ensure economic success. Trucking groceries and pet food to 
households was expensive, and few customers were willing to pay a premium for the added 
convenience. 

At the same time, many elementary schools spent tremendous resources to bring comput- 
ers and the Internet into the classroom. Indeed, it is easy to understand why teachers, school 
administrators, parents, politicians and equipment vendors are in favor of computers in 
classrooms. Isn’t computer literacy absolutely essential for youngsters in the new millen- 
nium? Isn’t it particularly important to give low-income kids, whose parents may not be able 
to afford a home computer, the opportunity to master computer skills? However, schools 
have found that the total cost of running computers far exceeds the initial cost of the equip- 
ment. As schools purchased more equipment than could be maintained by occasional 
volunteers, they had to make hard choices—should they lay off librarians and art instructors 
to hire more computer technicians, or should they let the equipment become useless? Unfor- 
tunately, many schools were so caught up in the technology hype that they never asked 
themselves whether the educational benefits justified the expense. See [3] for more 
information. 

As computer programmers, we like to computerize everything. As computer profession- 
als, though, we owe it to our employers and clients to understand which problems they want 
to solve aa to deploy computers and software only where they add more value than cost. 
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CHAPTER SUMMARY 


1. 
2. 
3. 


—y A a & 


10. 


11. 


12. 


13. 


14, 
15. 


16. 


The user interface of a web application is displayed in a web browser. 
A JavaServer Faces (JSF) page contains HTML and JSF tags. 


The JSF container converts a JSF page to an HTML page, replacing all JSF tags 
with text and HTML tags. 


. The Java objects of a JSF application are defined in a configuration file. 
. A value binding links a JSF component with a bean property. 
. The JSF technology enables the separation of presentation and business logic. 


. Properties of a software component can be accessed without having to write 


Java code. 


. A JavaBean is a class with a default constructor that exposes properties through 


its get and set methods. 


. A bean with session scope is available for multiple requests by the same 


browser. 


The value attribute of an input component denotes the value that the user 


supplies. 


Use an f:selectItems tag to specify all choices for a component that allows 
selection from a list of choices. 


The outcome string of an action determines the next page that the JSF container 
sends to the browser. 


A method binding specifies a bean and a method that should be invoked on the 
bean. 


A navigation rule maps outcome strings to JSF pages. 


A three-tier application has separate tiers for presentation, business logic, and 
data storage. 


You define data sources in the JSF container and use resource annotations to 
initialize them. 


FURTHER READING 


. http://glassfish.dev.java.net The web page for the GlassFish application server. 


. David Geary and Cay Horstmann, Core JavaServer Faces, 2nd ed., Sun Microsystems 


Press/Prentice Hall, 2007. 


. Oppenheimer, Todd. “The Computer Delusion,” The Atlantic Monthly 280, no. 1 July 


1997): 45-62, available online at http: //ww.catholiceducation.org/articles/ 
education/ed0026. html. 
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CLASSES, OBJECTS, AND METHODS 
INTRODUCED IN THIS CHAPTER 


java.text.DateFormat 
Format 
getTimeInstance 
setTimeZone 
java.util .LinkedHashMap 
java.util.TimeZone 
getAvai lableIDs 
getTimeZone 
javax.sql.DataSource 
getConnection 


REVIEW EXERCISES 

Exercise R24.1. What is the difference between a JSF page and a JSF container? 
Exercise R24.2. What is a bean? 

Exercise R24.3. What is a bean property? 

Exercise R24.4. Is a JButton a bean? Why or why not? 


Exercise R24.5. What is the software engineering purpose of using beans in conjunc- 
tion with JSF pages? 


Exercise R24.6. How are JSF variables (that is, the variables that are defined in 
faces-config.xm1 and referenced in value binding expressions) different from vari- 


ables in Java programs? 


Exercise R24.7. What are the choices for the scope of a bean? What is the default? 
When should you choose which scope? 


Exercise R24.8. How can you implement error checking in a JSF application? 
Explain, using a login page as an example. 


Exercise R24.9. What input elements can you place on a JSF form? What are their 
Swing equivalents? 


Exercise R24.10. What is the difference between a client-server application and a 
three-tier application? 


Additional review exercises are available in WileyPLUS. 
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PROGRAMMING EXERCISES 


Exercise P24.1. Write a JSF application that reports the values of the following sys- 
tem properties of the web server: 


e The Java version (java. version) 
e The operating system name (os.name) 
e The operating system version (os.version) 


Supply a bean that uses the getProperties method of the System class. 


Exercise P24.2. Write a JSF application that simulates two rolls of a die, producing an 
output such as “Rolled a 4 and a 6”. When the user reloads the page, a new pair of 
values should be displayed. Supply a bean that encapsulates a Random object. 


Exercise P24.3. Enhance Exercise P24.2 by producing a web page that shows images 
of the rolled dice. Find GIF images of dice with numbers 1 through 6 on the front, 
and generate an HTML page that references the appropriate images. Hint: Use the 
tag <h:graphicImage value=imageURL/> and take advantage of the fact that you can 
embed a value binding expression into regular text, such as 

"/image#{expression} .gif™ 


Exercise P24.4. Write a web application that allows a user to specify six lottery 
numbers. Generate your own combination on the server, and then print out both 
combinations together with a count of matches. 


Exercise P24.5. Add error checking to Exercise P24.4. If the lottery numbers are not 
within the correct range, or if there are duplicates, show an appropriate message and 
allow the user to fix the error. 


Exercise P24.6. Personalize the time zone application of Section 24.4. Prompt the 
user to log in and specify a city to be stored in a profile. The next time the user logs 
in, the time of their favorite city is displayed automatically. Store users, passwords, 
and favorite cities in a database. You need a logout button to switch users. 


Exercise P24.7. Extend Exercise P24.6 so that a user can choose multiple cities and all 
cities chosen by the user are remembered on the next login. 


Exercise P24.8. Write a web version of the ExecSQL utility of Chapter 22. Allow users 
to type arbitrary SQL queries into a text area. Then submit the query to the data- 
base and display the result. 


Exercise P24.9. Produce a web front end for the ATM program in Chapter 12. 


Exercise P24.10. Produce a web front end for the appointment calendar application 
of Exercise P12.7. 


Exercise P24.11. Produce a web front end for the airline reservation program of 
Exercise P12.8. 


Additional programming exercises are available in WileyPLUS. 
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PROGRAMMING PROJECTS 


Project 24.1. Write a shopping cart application. A database contains items that can 
be purchased and their prices, descriptions, and available quantities. If the user 
wants to check out, ask for the user account. If the user does not yet have an 
account, create one. The user name and address should be stored with the account 
in the database. Display an invoice as the last process in the checkout step. When 
the user has confirmed the purchase, update the quantities in the warehouse. 


Project 24.2. Write a web-based grade book application that your instructor might 
use to manage student grades in this course. Your application should have one 
account for the instructor, and one account for each student. Instructors can enter 
and view grades for all students. Students can only see their own grades and their 
ranking within the course. Implement the features that your instructor uses for 
determining the course grade (such as dropping the lowest quiz score, counting 
homework as 30% of the total grade, and so on.) All information should be stored 
in a database. 


ANSWERS TO SELF-CHECK QUESTIONS 


1. 


10. 


Each protocol has a specific purpose. HTML describes the appearance of a 
page; it would be useless for sending requests from a browser to a server. HTTP 
describes a request; it cannot describe the appearance of a page. 


. The data of the POST request contain a portion username=the name supplied by the 


user&password=the password supplied by the user. 


Place an image file, say clock.gif, into the datetime directory, and add a tag 
<img src="clock.gif"/> to the index.jsp file. 


. No~it is possible (and sadly common) for programmers to place the business 


logic into the frame and component classes of the user interface. 


The application server knows nothing about the files on your computer. You 
need to hand it the WAR file with all the application’s pages, code, and configu- 


ration files so that it can execute the application when it receives a web request. 


It contains the definitions of variables used in the JSF pages, such as the 
dateTime variable used in the index.jsp page of the datetime application. 


Technically, yes. It has a default constructor. However, it has no methods whose 
name start with get or set, so it exposes no properties. 


It sets the zone instance field to match the time zone of the city. 


When the zone bean was constructed, its city property was set to "Los 
Angeles". When the input field is rendered, its default value is the current value 
of the city property. 


h:selectOneRadio, h:selectOneMenu, or h:selectOneCheckbox 
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11. 


12. 


13. 
14. 
15. 


You would need a bean with a property such as the following: 


public Map<String, Integer> getYearChoices() 


{ 
Map<String, Integer> choices = new TreeMap<String, Integer>(); 
choices.put¢€"2003", 2003); 
choices.put¢C"2004", 2004); 
return choices; 
} 


Then supply a tag <f:selectItems value="#{creditCard.yearChoices}"/>. 


Add the tag <h: commandButton value="Help" action="help"/> to error.jsp, and 
add a navigation rule to faces-config.xm1: 
<navigation-case> 
<from-outcome>help</from-outcome> 
<to-view-id>/help.jsp</to-view-1d> 
</navigation-case> 


The current page would be redisplayed. 
Then the database connection would be kept open for the entire session. 


As long as there are cities, the next. jsp page is redisplayed. If all cities are 
removed, it is pointless to display the next.jsp page, so the application navi- 
gates to the index. jsp page. 


Appendix 


Java Language 
Coding Guidelines 


This coding style guide is a simplified version of one that has been used with good 
success both in industrial practice and for college courses. 

A style guide is a set of mandatory requirements for layout and formatting. Uni- 
form style makes it easier for you to read code from your instructor and classmates. 
You will really appreciate that if you do a team project. It is also easier for your 
instructor and your grader to grasp the essence of your programs quickly. 

A style guide makes you a more productive programmer because it reduces gra- 
tuitous choice. If you don’t have to make choices about trivial matters, you can 
spend your energy on the solution of real problems. 

In these guidelines, several constructs are plainly outlawed. That doesn’t mean 
that programmers using them are evil or incompetent. It does mean that the con- 
structs are not essential and can be expressed just as well or even better with other 
language constructs. 

It you already have programming experience, in Java or another language, you 
may be initially uncomfortable at giving up some fond habits. However, it is a sign 
of professionalism to set aside personal preferences in minor matters and to com- 
promise for the benefit of your group. 
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These guidelines are necessarily somewhat dull. They also mention features that 
you may not yet have seen in class. Here are the most important highlights: 
e ‘Tabs are set every three spaces. 


° Variable and method names are lowercase, with occasional upperCase characters 


in the middle. 
e Class names start with an Uppercase letter. 
e Constant names are UPPERCASE, with an occasional UNDER_SCORE. 
e There are spaces after keywords and surrounding binary operators. 
e Braces must line up horizontally or vertically. 
e No magic numbers may be used. 


e Every method, except for main and overridden library methods, must have a 
comment. 


e At most 30 lines of code may be used per method. 
¢ No continue or break is allowed. 


e All non-final variables must be private. 


Note to the instructor: Of course, many programmers and organizations have strong 
feelings about coding style. If this style guide is incompatible with your own prefer- 
ences or with local custom, please feel free to modify it. For that purpose, this cod- 
ing style guide is available in electronic form in the WileyPLUS course for this 


book. 


Each Java program is a collection of one or more source files. The executable 
program is obtained by compiling these files. Organize the material in each file as 
follows: 


© package statement, if appropriate 

® import statements 

e A comment explaining the purpose of this file 
e A public class 

e Other classes, if appropriate 


The comment explaining the purpose of this file should be in the format recognized 
by the javadoc utility. Start with a /**, and use the @author and @version tags: 


] = 
COPYRIGHT (C) 2007 Harry Hacker. All Rights Reserved. 
Classes to manipulate widgets. 
Solves CS101 homework assignment #3 
@author Harry Hacker 
@version 1.01 2007-02-15 


APPENDIXA 8% Java Language Coding Guidelines 1051 


Each 


class. 


class should be preceded by a class comment explaining the purpose of the 


First list all public features, then all private features. 
Within the public and private sections, use the following order: 


eS 


6. 


Constructors 
Instance methods 
Static methods 
Instance fields 


Static fields 


Inner classes 


Leave a blank line after every method. 

All non-final variables must be private. (However, instance variables of a private 
inner class may be public.) Methods and final variables can be either public or pri- 
vate, as appropriate. 

All features must be tagged public or private. Do not use the default visibility 
(that is, package visibility) or the protected attribute. 

Avoid static variables (except final ones) whenever possible. In the rare instance 
that you need static variables, you are permitted one static variable per class. 


Every method (except for main) starts with a comment in javadoc format. 


ale ole 
aoa 


ale 
aw 


Convert calendar date into Julian day. 

Note: This algorithm is from Press et al., Numerical Recipes 
in C, 2nd ed., Cambridge University Press, 1992. 

@param day day of the date to be converted 

@param month month of the date to be converted 

@param year year of the date to be converted 

@return the Julian day number that begins at noon of the 
given calendar date. 


public static int getJulianDayNumber(int day, int month, int year) 


{ 
} 


Parameter names must be explicit, especially if they are integers or Boolean: 


public Employee remove(int d, double s) 


// Huh? 


public Employee remove(int department, double severancePay) 


jp OR 
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Methods must have at most 30 lines of code. The method signature, comments, 
blank lines, and lines containing only braces are not included in this count. This rule 
forces you to break up complex computations into separate methods. 


Ram ashi a wa 


VV : 

2h EE UE fa fld 3 cao § Pad as ea Nee Se] bol fere Jen tee Se a a SSS ee ieee BEE 
Eee a, Aes ol hes > Be FIND Pee A ie Gl Een FEN, = PF &@ ews B&D UR an a eas Pee ee Renee 3 nee nae Sie it 
Bs Ea re I si eT sieht ries oreo aes ieee cuteion eres ese MPa Sm aes OBIE ag Soria te pe Nea Vip Maat UY ais ates Bee eB es ae ee et 


Do not define all variables at the beginning of a block: 


double xold; // Don’t 
double xnew; 
boolean more; 


t 
Define each variable just before it is used for the first time: 
rf 
double xold = Integer.parseInt(Cinput) ; 
boolean more = false; 
while (more) 
double xnew = (xold + a / xold) / 2; 
5 
} 


Do not define two variables on the same line: 
int dimes = 0, nickels = 0; // Don’t 
Instead, use two separate definitions: 


int dimes = 0; // OK 

Int nickels = 0; 

In Java, constants must be defined with the keyword final. If the constant is used 
by multiple methods, declare it as static final. It is a good idea to define static 
final variables as private if no other class has an interest in them. 

Do not use magic numbers! A magic number is a numeric constant embedded in 
code, without a constant definition. Any number except —1, 0, 1, and 2 is considered 
magic: 

if (p.getxQ) < 300) // Don’t 
Use final variables instead: 


final double WINDOW_WIDTH = 300; 


if (p.getX© < WINDOW_WIDTH) // OK 


Even the most reasonable cosmic constant is going to change one day. You think 
there are 365 days per year? Your customers on Mars are going to be pretty 
unhappy about your silly prejudice. Make a constant 
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public static final int DAYS PER_YEAR = 365; 


so that you can easily produce a Martian version without trying to find all the 365s, 
364s, 366s, 367s, and so on, in your code. 
When declaring array variables, group the [ ] with the type, not the variable. 


int[] values; // OK 
int values[]; // Ugh—this is an ugly holdover from C 


When using collections, use type parameters and not “raw” types. 


ArrayList<String> names = new ArrayList<String>Q; // OK 
ArrayList names = new ArrayListQ; // NotOK 


| ea pe GTA PE SE ee ek, SP ly ey ted feet Gop Pe ma Parciat pea 3 WE ORS eee en ee age et eid eg ee nn ae Gees a CNG RCRA ee Ra Fg PEGS FR ae AE ELE oe a OR FO ce EP I ed Da 2 EET 
ee Bi1 OR ase nes SNP ee A Toe i ee Se et SSS ee eee ee Peis eee eae Et pet eee Fe es ay EA Sd pier ee cp eAD Seer as ak i ees 
oly ek fae Ste an te En ey oe Hee Ry ed An Pegs ie A eat pg alge Acre oie he ce a tig <n hy SBOE Bn Sail Le ee Td aL Tap rete Ge SOR LPO RP ES gw eke Mente Ch GAs hn RS RO Senge lpg Mea hee SS Baan SRE ORE ie eee OES ae GPs Pa 
SS gS ed ae oe EE Se ge Oo a OE EA REE Pre ee ce EGR Pe Rg TS Ah a ee ED SOO as ae Oe I REI NE a A IN ON STEAD, | PES Oa a PEO ibs ESLER Sa ee NESSES 
| 


The if Statement 
Avoid the “if . . . if . . . else” trap. The code 


Tt (a ee oD 
Teo @ S 2 ot &. wis 
else .. .3 
will not do what the indentation level suggests, and it can take hours to find such a bug. 
Always use an extra pairof{ . . . } whendealingwith“if ...if .. . else”: 


if © = « » ) 
{ 


TT € «is w ) us es 
bff 1» « «. ¥ Gre necessary 
else... .3 


a oe ee 
t 
if }.% « « ) & -«. #3 
else... .3 
} // { . . . } not necessary, but they keep you out of trouble 


The for Statement 


Use for loops only when a variable runs from somewhere to somewhere with some 
constant increment/decrement: 


for (int i = 0; i < a.length; i++) 
System.out.printIn(a[i]); 


Or, even better, use the “for each” loop: 


for (int e : a) 
System.out.printIn(e) ; 


Do not use the for loop for weird constructs such as 


for (a = a / 2: count < ITERATIONS; System.out.println(xnew) ) 
J// Dont 
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Make such a loop into a while loop. That way, the sequence of instructions is much 
clearer. 


a=a/2; 
while Ccount < ITERATIONS) // OK 
{ 


System.out.printInCxnew) ; 


‘ 


Nonlinear Control Flow 


Avoid the switch statement, because it is easy to fall through accidentally to an 
unwanted case. Use if/else instead. 

Avoid the break or continue statements. Use another boolean variable to control 
the execution flow. 


Exceptions 
Do not tag a method with an overly general exception specification: 
Widget readWidget(Reader in) throws Exception // Bad 
Instead, specifically declare any checked exceptions that your method may throw: 


Widget readwidget(Reader in) 
throws IOException, MalformedwidgetException // Good 


Do not “squelch” exceptions: 


try 
{ 
double price = in.readDouble(); 
t 
catch CException e) 
{ } // Bad 


Beginners often make this mistake “to keep the compiler happy”. If the current 
method is not appropriate for handling the exception, simply use a throws specifica- 
tion and let one of its callers handle it. 


Naming Conventions 


The following rules specify when to use upper- and lowercase letters in identifier 
names. 


° All variable and method names and all data fields of classes are in lowercase 
(maybe with an occasional upperCase in the middle); for example, firstPlayer. 


¢ All constants are in uppercase (maybe with an occasional UNDER_SCORE); 
for example, CLOCK_RADIUS. 
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e All class and interface names start with uppercase and are followed by lowercase 
letters (maybe with an occasional UpperCase letter); for example, BankTeller. 


e Generic type variables are in uppercase, usually a single letter. 


Names must be reasonably long and descriptive. Use firstPlayer instead of fp. No 
drppng f vwls. Local variables that are fairly routine can be short (ch, 7) as long as 
they are really just boring holders for an input character, a loop counter, and so on. 
Also, do not use ctr, c, cntr, cnt, c2 for variables in your method. Surely these vari- 
ables all have specific purposes and can be named to remind the reader of them (for 
example, current, next, previous, result, ...). However, it is customary to use 
single-letter names, such as T or E for generic types. 


Indentation and White Space 


Use tab stops every three columns. That means you will need to change the tab stop 
setting in your editor! 
Use blank lines freely to separate parts of a method that are logically distinct. 
Use a blank space around every binary operator: 


xl = (-b - Math.sqrt(b * b- 4%* a* c)) / @ * a); 
// Good 


xl=(-b-Math. sqrt (b*b-4*a*c))/(2*a) ; 
// Bad 


Leave a blank space after (and not before) each comma or semicolon. Do not leave a 
space before or after a parenthesis or bracket in an expression. Leave spaces around 
the(. . . ) part of an if, while, for, or catch statement. 


1f ( =s= 0) y = 0; 


F(a, bLi}); 


Every line must fit in 80 columns. If you must break a statement, add an indentation 
level for the continuation: 


Start the indented line with an operator (if possible). 
If the condition in an if or while statement must be broken, be sure to brace the 
body in, even if it consists of only one statement: 


OPC sau sawaue nope aewecsun owes bis ehieen snag edeasen veseae es 


If it weren’t for the braces, it would be hard to separate the continuation of the con- 
dition visually from the statement to be executed. 
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Braces 
Opening and closing braces must line up, either horizontally or vertically: 


while (i <n) { System.out.printIn(a[li]); i++; } 


while (1 < n) 
{ 
System.out.printIn(ali]); 
T4453 
i 
Some programmers don’t line up vertical braces but place the { behind the key- 
word: 
while (i < n) { // DON’T 
System.out.printin(ali]); 
14++3 
} 
Doing so makes it hard to check that the braces match. 


Unstable Layout 
Some programmers take great pride in lining up certain columns in their code: 


firstRecord = other.firstRecord; 
lastRecord = other.lastRecord; 
cutoff = other.cutoff; 


This is undeniably neat, but the layout is not stable under change. A new variable 
name that is longer than the preallotted number of columns requires that you move 
all entries around: 

firstRecord = other.firstRecord; 

lastRecord = other.lastRecord; 


cutoff = other.cutoff; 
marginalFudgeFactor = other.marginalFudgeFactor; 


This is just the kind of trap that makes you decide to use a short variable name like 
mff instead. Use a simple layout that is easy to maintain as your programs change. 


: Appendix 


2 The Basic Latin 
and Latin- 1 Subsets 
of Unicode 


This appendix lists the Unicode characters that are most commonly used for 
processing Western European languages. A complete listing of Unicode characters 
can be found at http://unicode.org. 


Table 1 Selected Control Characters 


Character Code Decimal Escape Sequence 
Tab ‘\u0009 ' 9 pie 
Newline '\ 000A" 210 "\n! 
Return '\u000D' 13 Ar: 


Space "\u0020' 32 
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‘\u0021" 
“\uOO022" 
“\ 00023 : 
'\u0024' 
NUOO2Z 5+ 
"\u0026' 
'\u0027' 
"\u0028' 
'\u0029' 
"\u002A' 
'\u002B' 
“\UOOZE! 
"\u002D' 
“\UOOZE- 
"\UOO2ZF* 
‘\u0030' 
‘A\u0031" 
"\u0032 ' 
E\U0033# 
"\u0034' 
"\u0035' 
'\u0036' 
-XU0037- 
‘\u0038' 
"\u0039' 
"\u003A' 
'\u003B' 
s\UOOSG: 
"\u003D' 
'\u003E' 
"\u003F ' 


Table 2 The Basic Latin (ASCII) Subset of Unicode 


Dec. 


33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
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Code 
'\u0040' 
\U004E- 
"\u0042' 
"\u0043' 
"\u0044' 
"\u0045' 
"\u0046' 
NU0047- 
"\u0048 ' 
"\u0049 ' 
'\u004A' 
"\u004B ' 
"\u004C' 
"\u004D' 
"\uQ004E' 
"\u004F' 
"\u0050' 
*\U00S 1" 
‘\u0052' 
"\u0053' 
‘\u0054' 
F\U005 5— 
"\u0056' 
"\u0057' 
"\u0058' 
"\u0059' 
"\u005A' 
'\u005B' 
ENUOOSC” 
"\u005D' 
'\uOO5E' 
‘\UOO5F* 


Dec. 


64 
65 
66 
67 
68 
69 
70 
7A 
72 
12 
74 
7) 
76 
77. 
78 
7 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
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Code 
"\u0060' 
‘\u0061' 
"\u0062' 
‘\u0063' 
"\u0064 ' 
‘\u0065S* 
‘\u0066' 
"\u0067' 
'\u0068' 
"\u0069' 
"\u006A' 
"\u006B ' 
"\u006C' 
"\uQ06D' 
"\UQO6E' 
\UOOGE? 
"\u0070' 
NUOO7Z L* 
‘\uU00722 
‘\U0073. 
"\u0074' 
-\UOOZ5. 
*\u00Z6: 
‘\U0077 ' 
"\u0078' 
"\u0079' 
"\u007A' 
"\u007B ' 
"\u007C' 
"\u007D' 
eNUOOZEs 


Dec. 
96 
97 
98 
99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
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Code 


"\uOOAL' 
"\uO0A2' 
"\u00A3 ' 
"\uO00A4 ' 
"\uO0A5 ' 
"\uQ0A6' 
"\u00A7' 
"\u00A8 ' 
"\uQ0A9 ' 
"\uQO0AA ' 
"\UOQOAB ' 
"\uQOAC' 
'\uOOAD' 
"\UOOAE ' 
'\UOOAF ' 
"\uO0BO' 
"\uOOB1' 
"\uO0B2 ' 
‘\u00B3. 


~'\u00B4' 


"\uQ0B5 ' 
'\uOOB6' 
'\u00B7 ' 
"\u00B8' 
"\u00B9' 
"\uQOBA' 
"\uOQOBB ' 
"\uOOBC' 
"\uQOBD' 
"\UuOOBE' 
‘XUOOBE- 
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Table 3. The Latin-1 Subset of Unicode 


Dec. 


161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
L 77 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 


Char. 
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Code 
'\u00C0' 
"\uO00C1' 
"\u00C2 ' 
"\u00C3 ' 
"\u00C4 ' 
"\u00C5 ' 
"\u00C6' 
‘\UO0CZ: 
'\u00C8' 
"\u00C9' 
"\u00CA'" 
"\uO0CB ' 
"\u00CC' 
"\uO00CD' 
"\uO0CE ' 
"\uO0OCF ' 
"\u00DO0' 
"\u00D1' 
"\u00D2' 
"\u00D3 ' 
"\u00D4 ' 
'\u00D5 ' 
"\u00D6' 
"\u00D7 ' 
'\u00D8 ' 
'\u00D9' 
"\uOODA' 
"\uOODB ' 
"\u00DC' 
'\ uOODD ' 
"\uQODE' 
"\uQODF ' 


Dec. 


192 
193 
194 
195 
196 
197 
198 
17 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
2A 
215 
216 
27 
218 
219 
220) 
224 
222 
223 


Char. 


a 


Dv 


Ov 


M> 


wa 


Code 
P\UDOEO” 
“\UOOEL! 
»\UOOE2 | 
"\u00E3' 
"\u00E4 ' 
"\uQOE5 ' 
"\uO0E6' 
‘\UQOEZ= 
"\u00E8' 
"\uQ0E9 ' 
"\UQOEA' 
"\uOOEB' 
"\UQOEC' 
"\uQOED' 
»\UOOEE 
V\UQOEF 
PNUOOEO? 
“\UOOFL- 
‘\UOOF2' 
'\uO00F3 ' 
"\uO0F4 ' 
“\UOOF DS! 
"\uOOF6' 
'\UOQOF7' 
"\uO00F8 ' 
"\UOOF9.” 
"\uOO0FA' 
"\UOOFB ' 
\UOOEC: 
"\uOOFD' 
“\NUOOFE? 
‘NUOOEE:’ 
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224 
225 
226 
pL 
228 
229 
230 
231 
252 
2353 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
25a 
252 
253 
254 
209 


Appendix 


The Java 
Library 


This appendix lists all classes and methods from the standard Java library that are 
used in this book. 

In the following inheritance hierarchy, superclasses that are not used in this book 
are shown in parentheses. Some classes implement interfaces not covered in this 
book; they are omitted. Classes are sorted first by package, then alphabetically 
within a package. 


java.awt. Shape 
jJava.7o0.Serializable 
java. lang.Cloneable 
java.lang.Object 
java.awt.BorderLayout implements Serializable 
java.awt.Color implements Serializable 
jJava.awt.Component implements Serializable 
java.awt.Container 
javax.swing.JComponent 
javax.swing.AbstractButton 
javax.swing.JButton 
javax.swing.JMenultem 
javax.swing.JMenu 
(javax.swing.JToggleButton) 
javax. swing. JCheckBox 
javax.swing.JRadioButton 
jJavax.swing. JComboBox 
javax.swing.JFileChooser 
javax.swing.JLabel 
javax.swing.JMenuBar 
javax.swing. JPanel 
javax.swing.JOptionPane 
javax.swing.JScrollPane 
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javax.swing.JSlider 
javax.swing.text.JTextComponent 
javax.swing.JTextArea 
javax.swing.JTextField 
(java.awt. Panel) 
java.applet.Applet 
javax.swing.JApplet 
(java. awt.Window) 
java.awt.Frame 
javax.swing.JFrame 
(java.awt.Dimension2D) 
java.awt.Dimension implements Cloneable, Serializable 
java.awt.FlowLayout implements Serializable 
java.awt.Font implements Serializable 
java.awt.Graphics 
java.awt.Graphics2D; 
java.awt.GridLayout implements Serializable 
java.awt.event.MouseAdapter implements MouseListener 
java.awt.geom.Line2D implements Cloneable, Shape 
java.awt.geom.Line2D.Double implements Serializable 
java.awt.geom.Point2D implements Cloneable 
java.awt.geom.Point2D.Double implements Serializable 
java.awt.geom.RectangularShape implements Cloneable, Shape 
(java.awt.geom.Rectangle2D) 
java.awt.Rectangle implements Serializable 
java.awt.geom.Ellipse2D 
java.awt.geom.Ellipse2D.Double implements Serializable 
java.io.File implements Comparable, Serializable 
java.1o0.InputStream 
java.io.FileInputStream 
java.io.ObjectInputStream 
java.io.OutputStream 
java.io.FileOutputStream 
(java.io. FilterOutputStream) 
java.io.PrintStream 
java.io.ObjectOutputStream 
java.io.RandomAccessFi le 
java.io.Reader 
(java.io. InputStreamReader) 
java.io.FileReader 
java.io.Writer 
java.io.PrintWriter 
(java.io.OutputStreamWriter) 
java.io.Filewriter 
java.lang.Boolean implements Serializable 
java.lang.Character implements Comparable, Serializable 
java.lang.Class implements Serializable 
java. lang.Math 
(java.lang.Number implements Serializable) 
java.math.BigDecimal implements Comparable 
java.math.BigInteger implements Comparable 
java.lang.Double implements Comparable 
java. lang.Integer implements Comparable 
java.lang.String implements Comparable, Serializable 
java. lang.System 
java.lang.Thread implements Runnable 
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java. lang. Throwable 
java. lang.Error 
java. lang.Exception 
java. lang.CloneNotSupportedException 
java. lang. InterruptedException 
java.io.IOException 
java.io.EOFException 
java.10.FileNotFoundException 
java. lang.RuntimeException 
java. lang.I1]legalArgumentException 
java. lang.NumberFormatException 
java. lang.I]legalStateException 
java.util.NoSuchElementException 
java.util.InputMismatchException 
java. lang.Nul1PointerException 
java.sql.SQLException 
(javax.xml.xpath.XPathException) 
jJavax.xml.xpath.XPathExpressionException 
java.net.ServerSocket 
java.net.Socket 
jJava.net.URL implements Serializable 
java.net.URLConnection 
jJava.net.HttpURLConnection 
java.sql.DriverManager 
(java.text.Format implements Cloneable, Serializable) 
java.text.DateFormat 
(java.util .AbstractCol lection<E>) 
Cjava.util.AbstractList<E>) 
(java.util.AbstractSequentialList<E>) 
java.util.LinkedList<E> implements Cloneable, List<E>, Serializable 
jJava.util.ArrayList<E> implements Cloneable, List<E>, Serializable 
(java.util .AbstractQueue<E>) 
java.util.PriorityQueue<E> implements Serializable 
(java.util .AbstractSet<E>) 
java.util.HashSet<E> implements Cloneable, Serializable, Set<E> 
java.util.TreeSet<E> implements Cloneable, Serializable, SortedSet<E> 
(java.util.AbstractMap<K, V>) 
java.util.HashMap<K, V> implements Cloneable, Map<K, V>, Serializable 
java.util.LinkedHashMap<K, V> 
java.util.TreeMap<K, V> implements Cloneable, Serializable, Map<K, V> 
java.util.Arrays 
java.util.Collections 
java.util.Calendar 
java.util.GregorianCalendar 
java.util.Date implements Serializable 
(java.util.Dictionary<K, V>) 
(java.util.Hashtable<K, V>) 
jJava.util.Properties implements Serializable 
java.util.EventObject implements Serializable 
Cjava.awt.AWTEvent) 
java.awt.event.ActionEvent 
(java.awt.event.ComponentEvent) 
(java.awt.event. InputEvent) 
java.awt.event.MouseEvent 
javax.swing.event.ChangeEvent 
java.util.Random implements Serializable 
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Scanner 

TimeZone implements Cloneable, Serializable 

concurrent. locks.ReentrantLock implements Lock, Serializable 
logging.Level implements Serializable 

logging.Logger 


javax.swing.ButtonGroup implements Serializable 
javax.swing.ImageIcon implements Serializable 


javax.swing.Timer implements Serializable 
(javax.swing.border.AbstractBorder implements Serializable) 
javax.swing.border.EtchedBorder 
javax.swing.border.TitledBorder 
javax.xml.parsers.DocumentBui Ider 
javax.xml.parsers.DocumentBui lderFactory 
javax.xml.xpath.XPathFactory 
java. lang. Comparable<T> 
java. lang.Runnable | 
java.sql.Connection 
java.sql.ResultSet 
java.sql.ResultSetMetaData 
java.sql.Statement 
java.sql.PreparedStatement 
java.util1.Collection<E> 
java.util.List<E> 
java.uti].Set<E> 
java.util.SortedSet<E> 


java.uti1.Comparator<IT> 
(jJava.uti].EventListener) 
java.awt.event.ActionListener 
java.awt.event.MouseListener 


javax.swing.event.ChangeListener 


java.uti].Iterator<E> 
java.util.ListIterator<E> 


java.util.Map<K, V> | 
java.util.concurrent. locks.Condition 

java.util.concurrent. locks.Lock 
javax.xml.xpath.XPath 
org.w3c.dom.DOMConfiguration 


org.w3c.dom.DOMImplementaton 
(Corg.w3c.dom. Node) 


(org.w3c.dom. CharacterData) 
org.w3c.dom. Text 
org.w3c.dom.Document 
org.w3c.dom.Element | 
org.w3c.dom.1s.DOMImplementationLS 
org.w3c.dom.1s.LSSerializer 
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In the following descriptions, the phrase “this object” (“this component”, “this 
container”, and so forth) means the object (component, container, and so forth) on 
which the method is invoked (the implicit parameter, this). 


Class java.applet.Applet 


® void destroy() 
This method is called when the applet is about to be terminated, after the last call to stop. 
® void init() 
This method is called when the applet has been loaded, before the first call to start. 
Applets override this method to carry out applet-specific initialization and to read applet 
parameters. 
® void start() 
This method is called after the init method and each time the applet is revisited. 


® void stop() 
This method is called whenever the user has stopped watching this applet. 


Class java. awt.BorderLayout 


© BorderLayout() 

This constructs a border layout. A border layout has five regions for adding components, 

called "North", "East", "South", "West", and "Center". 
@ static final int CENTER 

This value identifies the center position of a border layout. 
® static final int EAST 

This value identifies the east position of a border layout. 
® static final int NORTH 

This value identifies the north position of a border layout. 
® static final int SOUTH 

This value identifies the south position of a border layout. 
® static final int WEST 

This value identifies the west position of a border layout. 


Class java.awt.Color 


® Color(float red, float green, float blue) 
This creates a color with the specified red, green, and blue values between 0.0F and 1.0F. 
Parameters: red The red component 
green The green component 
blue The blue component 
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Class java. awt.Component 


| ® void addMouseListener(MouseListener listener) 
This method adds a mouse listener to the component. 
Parameters: listener The mouse listener to be added 
® int getHeight( 
This method gets the height of this component. 
Returns: The height in pixels. 
® int getWwidth( 
This method gets the width of this component. 
Returns: The width in pixels. 
® void repaint(Q 
This method repaints this component by scheduling a call to the paint method. 
© void setPreferredSize(Dimension preferredSize) 
This method sets the preferred size of this component. 
® void setSize(int width, int height) 
This method sets the size of this component. 
Parameters: width the component width 
height the component height 
® void setVisible(boolean visible) 
This method shows or hides the component. 
Parameters: visible true to show the component, or false to hide it 


Class java.awt.Container 


® void add(Component c) 
® void add(Component c, Object position) 


These methods add a component to the end of this container. If a position is given, the 
layout manager is called to position the component. 


Parameters: c The component to be added 


position An object expressing position information for the layout 
manager 


® void setLayout(LayoutManager manager) 
This method sets the layout manager for this container. 
Parameters: manager A layout manager 


Class java.awt.Dimension 


® Dimension(int width, int height) 


This constructs a Dimension object with the given width and height. 
Parameters: width The width 
height The height 
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Class java. awt.FlowLayout 
® FlowLayout() 


This constructs a new flow layout. A flow layout places as many components as possible 
in a row, without changing their size, and starts new rows when necessary. 


Class java.awt.Font 
® Font(String name, int style, int size) 
This constructs a font object from the specified name, style, and point size. 


Parameters: name The font name, either a font face name or a logical font name, which 
must be one of "Dialog", "DialogInput", "Monospaced", "Serif", or 
"SansSerif" 


style One of Font. PLAIN, Font. ITALIC, Font.BOLD, or 
Font. TTALIC+Font. BOLD 


size The point size of the font 


Class java.awt.Frame 
® void setTitle(String title) 
This method sets the frame title. 
Parameters: title The title to be displayed in the border of the frame 


Class java.awt.Graphics 
® void setColor(Color c) 


This method sets the current color. From now on, all graphics operations use this color. 
Parameters: c The new drawing color 


Class java. awt.Graphics2D 
® void draw(Shape s) 


This method draws the outline of the given shape. Many classes—among them Rectangle 
and Line2D.Double—implement the Shape interface. 


Parameters: s The shape to be drawn 
® void drawString(String s, int x, int y) 
® void drawString(String s, float x, float y) 

These methods draw a string in the current font. 

Parameters: s The string to draw 

x,y The basepoint of the first character in the string 

® void fill(CShape s) 

This method draws the given shape and fills it with the current color. 

Parameters: s The shape to be filled 


APPENDIXC #8 The Java Library 1067 


Class java.awt.GridLayout 


GridLayout(Cint rows, int cols) 


This constructor creates a grid layout with the specified number of rows and columns. 
The components in a grid layout are arranged ina grid with equal widths and heights. 
One, but not both, of rows and cols can be zero, in which case any number of objects can 
be placed in a row or in a column, respectively. 
Parameters: rows The number of rows in the grid 

cols The number of columns in the grid 


Class java.awt.Rectangle 


Rectangle() 


This constructs a rectangle whose top left corner is at (0, 0) and whose width and height 
are both zero. 


Rectangle(int x, int y, int width, int height) 
This constructs a rectangle with given top-left corner and size. 
Parameters: x,y The top-left corner 
width The width 
height The height 
double getHeight() 
double getWidth() 
These methods get the height and width of the rectangle. 
double getX() 
double getY() 
These methods get the x- and y-coordinates of the top-left corner of the rectangle. 
Rectangle intersection(Rectangle other) 
This method computes the intersection of this rectangle with the specified rectangle. 
Parameters: other A rectangle 
Returns: The largest rectangle contained in both this and other 
void setLocation(int x, int y) 
This method moves this rectangle to a new location. 
Parameters: x,y The new top-left corner 
void translate(int dx, int dy) 
This method moves this rectangle. 
Parameters: dx The distance to move along the x-axis 
dy The distance to move along the y-axis 
Rectangle union(Rectangle other) 
This method computes the union of this rectangle with the specified rectangle. This is not 
the set-theoretic union but the smallest rectangle that contains both this and other. 
Parameters: other A rectangle 
Returns: The smallest rectangle containing both this and other 


Interface java.awt.Shape 
The Shape interface describes shapes that can be drawn and filled by a Graphics2D object. 
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Interface java.awt.event.ActionListener 


® void actionPerformed(ActionEvent e) 
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The event source calls this method when an action occurs. 


Class java.awt.event .MouseEvent 
© int getxQd 


This method returns the horizontal position of the mouse as of the time the event 
occurred. 


Returns: The x-position of the mouse 

® int getYQ 
This method returns the vertical position of the mouse as of the time the event occurred. 
Returns: The y-position of the mouse 


Interface java.awt.event.MouseListener 


® void mouseClicked(MouseEvent e) 


This method is called when the mouse has been clicked (that is, pressed and released in 
quick succession). 


® void mouseEntered(MouseEvent e) 
This method is called when the mouse has entered the component to which this listener 


was added. 


@ void mouseExited(MouseEvent e) 


This method is called when the mouse has exited the component to which this listener 


was added. 
® void mousePressed(MouseEvent e) 

This method is called when a mouse button has been pressed. 
® void mouseReleased(MouseEvent e) 

This method is called when a mouse button has been released. 


Class java.awt.geom.E11ipse2D.Double 


® Ellipse2D.Double(double x, double y, double w, double h) 
This constructs an ellipse from the specified coordinates. 
Parameters: x, y The top-left corner of the bounding rectangle 

w The width of the bounding rectangle 
h The height of the bounding rectangle 
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Class java. awt.geom.Line2D 


® double getXlQ 
® double getX2() 
® double getY1Q 
® double getY2() 
These methods get the requested coordinate of an endpoint of this line. 
Returns: The x- or y-coordinate of the first or second endpoint 
® void setLine(double x1, double yl, double x2, double y2) 
This methods sets the endpoints of this line. 
Parameters: x1, yl A new endpoint of this line 
x2, y2 The other new endpoint 


Class java.awt.geom.Line2D.Double 
® Line2D.Double(double x1, double yl, double x2, double y2) 
This constructs a line from the specified coordinates. 
Parameters: x1, yl One endpoint of the line 
x2, y2 The other endpoint 
® Line2D.Double(Point2D pl, Point2D p2) 
This constructs a line from the two endpoints. 
Parameters: pl, p2 The endpoints of the line 


Class java.awt.geom.Point2D 


® double getX() 

® double getY(Q 
These methods get the requested coordinates of this point. 
Returns: The x- or y-coordinate of this point 

® void setLocation(double x, double y) 
This method sets the x- and y-coordinates of this point. 
Parameters: x, y The new location of this point 


Class java.awt.geom.Point2D.Double 


® Point2D.Double(double x, double y) 
This constructs a point with the specified coordinates. 
Parameters: x, y The coordinates of the point 


Class java.awt.geom.RectangularShape 
© int getHeight() 
® int getWidth() 
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These methods get the height or width of the bounding rectangle of this rectangular 


shape. 
Returns: The height or width, respectively 
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Package java.awt.geom 


Package java.io 
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double getCenterXx() 
double getCenteryY () 
double getMaxX() 
double getMaxY() 
double getMinx() 
double getMinY() 


These methods get the requested coordinate value of the corners or center of the 
bounding rectangle of this shape. 


Returns: The center, maximum, or minimum x- and y-coordinates 
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Class java. io.EOFException 


EOFException(String message) 
This constructs an “end of file” exception object. 
Parameters: message The detail message 


Class java.io.File 


File(String name) 

This constructs a File object that describes a file (which may or may not exist) with the 
given name. 

Parameters: name The name of the file 

boolean exists() 


This method checks whether there is a file in the local file system that matches this File 
object. 


Returns: true if there is a matching file, false otherwise 
static final String pathSeparator 


The sytem-dependent separator between path names. A colon (:) in Linux or Mac OS X; 
a semicolon (;) in Windows. 


Class java. io.FileInputStream 


FileInputStream(File f) 


This constructs a file input stream and opens the chosen file. If the file cannot be opened 
for reading, a Fi leNotFoundException is thrown. 


Parameters: f The file to be opened for reading 
FileInputStream(String name) 


This constructs a file input stream and opens the named file. If the file cannot be opened 
for reading, a FileNotFoundException is thrown. 


Parameters: name The name of the file to be opened for reading 


Class java. io.FileNotFoundException 


This exception is thrown when a file could not be opened. 
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Class java.io. FileQutputStream 


FileOutputStream(File f) 


This constructs a file output stream and opens the chosen file. If the file cannot be opened 
for writing, a FileNotFoundException is thrown. 


Parameters: f The file to be opened for writing 
FileOutputStream(String name) 


This constructs a file output stream and opens the named file. If the file cannot be opened 
for writing, a Fi leNotFoundException is thrown. 


Parameters: name The name of the file to be opened for writing 


Class java. io.FileReader 


FileReader(File f) 


This constructs a file reader and opens the chosen file. If the file cannot be opened for 
reading, a Fi leNotFoundException is thrown. 


Parameters: f The file to be opened for reading 
FileReader(String name) 


This constructs a file reader and opens the named file. If the file cannot be opened for 
reading, a FileNotFoundException is thrown. 


Parameters: name The name of the file to be opened for reading 


Class java.io.FileWriter 


FileWriter(File f) 


This constructs a file writer and opens the chosen file. If the file cannot be opened for 
writing, a Fi leNotFoundException is thrown. 


Parameters: f The file to be opened for writing 
FileWriter(String name) 


This constructs a file writer and opens the named file. If the file cannot be opened for 
writing, a FileNotFoundException is thrown. 


Parameters: name The name of the file to be opened for writing 


Class java.io. InputStream 


void close() 


This method closes this input stream (such as a FileInputStream) and releases any system 
resources associated with the stream. 


int read() 
This method reads the next byte of data from this input stream. 
Returns: The next byte of data, or -1 if the end of the stream is reached. 


Class java. io. InputStreamReader 


InputStreamReader (InputStream in) 
This constructs a reader from a specified input stream. 
Parameters: in The stream to read from 
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Class java.io. IOException 


This type of exception is thrown when an input/output error is encountered. 


Class java. io.ObjectInputStream 


® ObjectInputStreamCInputStream in) 
This constructs an object input stream. 
Parameters: in The stream to read from 
® Object readObject() 
This method reads the next object from this object input stream. 
Returns: The next object 


Class java. io.ObjectOutputStream 


® ObjectOutputStream(OutputStream out) 
This constructs an object output stream. 
Parameters: out The stream to write to | 
® Object writeObject (Object obj) 
This method writes the next object to this object output stream. 
Parameters: obj The object to write 


Class java. io.OutputStream 


® void close() 


This method closes this output stream (such as a Fi leOutputStream) and releases any 
system resources associated with this stream. A closed stream cannot perform output 
operations and cannot be reopened. 


® void writeC€int b) 
This method writes the lowest byte of b to this output stream. 
Parameters: b The integer whose lowest byte is written 


Class java. io.PrintStream 
® void printCint x) 

® void print(double x) 

® void print(Object x) 

® void print(String x) 

® void printing) 

® void printin(int x) 

® void printIn(double x) 

® void printin(Object x) 

® void printin(String x) 


These methods print a value to this print stream. The printIn methods print a newline 
after the value. Objects are printed by converting them to strings with their toString 
methods. 


Parameters: x The value to be printed 
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® PrintStream printf(Sting format, Object... values) 


This method prints the format string, substituting the given values for placeholders that 
start with %. 


Parameters: format The format string 


values The values to be printed. You can supply any number of values 
Returns: The implicit parameter 


Class java.io.PrintWriter 


® PrintWriter(String name) 


This constructs a print writer and opens the named file. If the file cannot be opened for 
writing, a Fi leNotFoundException is thrown. 


Parameters: name The name of the file to be opened for writing 
® PrintWriter(Writer out) 
This constructs a print writer from a specified writer (such as a FileWriter). 
Parameters: out The writer to write output to 
® void close() 
This method closes this writer and releases any associated system resources. 
® void print(Cint x) 
® void print(double x) 
® void print(Object x) 
® void print(String x) 
® void printing) 
® void printIin(Cint x) 
® void printin(double x) 
® void printIn(Object x) 
® void printin(String x) 


These methods print a value to this print writer. The printIn methods print a newline 
after the value. Objects are printed by converting them to strings with their toString 
methods. 


Parameters: x The value to be printed 


Class java.io.RandomAccessFile 


® RandomAccessFile(String name, String mode) 
This method opens a named random access file for reading or read/write access. 
Parameters: name The file name 
mode "r" for reading or "rw" for read/write access 
® long getFilePointer() 
This method gets the current position in this file. 
Returns: The current position for reading and writing 
® long length() 
This method gets the length of this file. 
Returns: The file length 


Package java.io 
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@ char readChar() 

® double readDouble() 

® int readintQ 
These methods read a value from the current position in this file. 
Returns: The value that was read from the file 

® void seek(long position) 
This method sets the position for reading and writing in this fle. 
Parameters: position The new position 

® void writeChar(Cint x) 

© void writeChars(String x) 

® void writeDouble(double x) 

© void writeInt(int x) 
These methods write a value to the current position in this file. 
Parameters: x ‘The value to be written 


Class java. io.Reader 
® void close() 
This method closes this reader and releases any associated system resources. 
© int read () 
This method reads the next character from this reader (such as a FileReader). 
Returns: The next character, or —-1 if the end of the input is reached 


Interface java.io.Serializable 


A class must implement this interface to enable its objects to be written to object streams. 


Class java. io.Writer 


® void close() 
This method closes this writer and releases any associated system resources. 

® void write(int b) 
This method writes the lowest two bytes of b to this writer (such as a FileWriter). 
Parameters: b The integer whose lowest two bytes are written 
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Class java. lang.Boolean 


® Boolean(boolean value) 
This constructs a wrapper object for a boolean value. 
Parameters: value The value to store in this object 
® boolean booleanValue() 
This method returns the boolean value stored in this Boolean object. 
Returns: The Boolean value of this object 
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Class java. 1lang.Character 


static boolean isDigit(ch) 

This method tests whether a given character is a Unicode digit. 
Parameters: ch The character to test 

Returns: true if the character is a digit 

Static boolean isLetter(ch) 

This method tests whether a given character is a Unicode letter. 
Parameters: ch The character to test 

Returns: true if the character is a letter 

static boolean isLowerCase(ch) 

This method tests whether a given character is a lowercase Unicode letter. 
Parameters: ch The character to test 

Returns: true if the character is a lowercase letter 

Static boolean isUpperCase(ch) 

This method tests whether a given character is an uppercase Unicode letter. 
Parameters: ch The character to test 

Returns: true if the character is an uppercase letter 


Class java. lang.Class 


static Class forName(String className) 

This method loads a class with a given name. Loading a class initializes its static fields. 
Parameters: className The name of the class to load 

Returns: The type descriptor of the class 


Interface java. lang.Cloneable 


A class implements this interface to indicate that the Object.clone method is allowed to 
make a shallow copy of its instance variables. 


Class java. lang.CloneNotSupportedException 


This exception is thrown when a program tries to use Object.clone to make a shallow 
copy of an object of a class that does not implement the Cloneable interface. 


Interface java. lang.Comparabl e<T> 


int compareTo(T other) 
This method compares this object with the other object. 
Parameters: other The object to be compared 


Returns: A negative integer if this object is less than the other, zero if they are equal, or 
a positive integer otherwise 
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Class java. lang.Double 


Double(double value) 

This constructs a wrapper object for a double-precision floating-point number. 
Parameters: value The value to store in this object 

double doubleValue() 

This method returns the floating-point value stored in this Double wrapper object. 
Returns: The value stored in the object 

static double parseDouble(String s) 

This method returns the floating-point number that the string represents. If the string 
cannot be interpreted as a number, a NumberFormatException is thrown. 
Parameters: s ‘The string to be parsed 

Returns: The value represented by the string parameter 


Class java. lang.Error 


This is the superclass for all unchecked system errors. 


Class java. lang.1I1legalArgumentException 


I1legalArgumentException() 
This constructs an I11egalArgumentException with no detail message. 


Class java. lang.I1legalStateException 


This exception is thrown if the state of an object indicates that a method cannot currently 


be applied. 


Class java. lang. Integer 


Integer(int value) 
This constructs a wrapper object for an integer. 
Parameters: value The value to store in this object 
int intValue() 
This method returns the integer value stored in this wrapper object. 
Returns: The value stored in the object 
static int parseInt(String s) 
This method returns the integer that the string represents. If the string cannot be 
interpreted as an integer, a NumberFormatException is thrown. 
Parameters: s The string to be parsed 
Returns: The value represented by the string parameter 
static Integer parseInt(String s, int base) 
This method returns the integer value that the string represents in a given number system. 
If the string cannot be interpreted as an integer, a NumberFormatException is thrown. 
Parameters: s The string to be parsed 
base The base of the number system (such as 2 or 16) 
Returns: The value represented by the string parameter 
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Static String toString(Cint 7) 
Static String toString(int i, int base) 


This method creates a string representation of an integer in a given number system. If no 
base is given, a decimal representation is created. 


Parameters: i An integer number 
base The base of the number system (such as 2 or 16) 


Returns: A string representation of the number parameter in the specified number 
system 


Static final int MAX_VALUE 

This constant is the largest value of type int. 

static final int MIN_VALUE 

This constant is the smallest (negative) value of type int. 


Class java. 1lang.InterruptedException 


This exception is thrown to interrupt a thread, usually with the intent of terminating it. 


Class java. lang.Math 


static double abs(double x) 

This method returns the absolute value |x|. 

Parameters: x A floating-point value 

Returns: The absolute value of the parameter 

static double acos(double x) 

This method returns the angle with the given cosine, cos! x € [0, 7]. 
Parameters: x A floating-point value between —1 and 1 

Returns: The arc cosine of the parameter, in radians 

static double asin(double x) 

This method returns the angle with the given sine, sin”! x € [-7/2, 1/2]. 
Parameters: x A floating-point value between —1 and 1 

Returns: The arc sine of the parameter, in radians 

static double atan(double x) 

This method returns the angle with the given tangent, tan! x (1/2, 2/2). 
Parameters: x A floating-point value 

Returns: The arc tangent of the parameter, in radians 

static double atan2(double y, double x) 


This method returns the arc tangent, tan”! (y/x) € (—7, 2). If x can equal zero, or if it is 
necessary to distinguish “northwest” from “southeast” and “northeast” from “south- 
west”, use this method instead of atan(y/x). 


Parameters: y,x Two floating-point values 

Returns: The angle, in radians, between the points (0,0) and (x,y) 
static double ceil(double x) 

This method returns the smallest integer 2x (as a double). 
Parameters: x A floating-point value 

Returns: The “ceiling integer” of the parameter 
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® static double cos(double radians) 
This method returns the cosine of an angle given in radians. 
Parameters: radians An angle, in radians 
Returns: The cosine of the parameter 
@® static double exp(double x) 
This method returns the value e*, where e is the base of the natural logarithms. 
Parameters: x A floating-point value 
Returns: e* 
® static double floor(double x) 
This method returns the largest integer <x (as a double). 
Parameters: x A floating-point value 
Returns: The “floor integer” of the parameter 
® static double log(double x) 
This method returns the natural (base e) logarithm of x, In x. 
Parameters: x A number greater than 0.0 
Returns: The natural logarithm of the parameter 
® static int maxCint x, int y) 
® static double max(double x, double y) 
These methods return the larger of the given parameter values. 
Parameters: x, y Two integers or floating-point values 
Returns: The maximum of the parameter values 
®@ static int minCint x, int y) 
® static double min(double x, double y) 
These methods return the smaller of the given parameter values. 
Parameters: x, y Two integers or floating-point values 
Returns: The minimum of the parameter values 
® static double pow(double x, double y) 
This method returns the value x” (x > 0, or x =O and y > 0, or x <0 and y is an integer). 
Parameters: x, y Two floating-point values 
Returns: The value of the first parameter raised to the power of the second parameter 


® static long round(double x) 
This method returns the closest long integer to the parameter. 
Parameters: x A floating-point value 
Returns: The value of the parameter rounded to the nearest long value 
® static double sin(double radians) 
This method returns the sine of an angle given in radians. 
Parameters: radians An angle, in radians 
Returns: The sine of the parameter 
@ static double sqrt(Cdouble x) 
This method returns the square root of x, Vx. 
Parameters: x A nonnegative floating-point value 
Returns: The square root of the parameter 
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® static double tan(Cdouble radians) 
This method returns the tangent of an angle given in radians. 
Parameters: radians An angle, in radians 
Returns: The tangent of the parameter 
® static double toDegrees(double radian) 
This method converts radians to degrees. 
Parameters: radians An angle, in radians 
Returns: The angle in degrees 
® static double toRadians(double degrees) 
This methods converts degrees to radians. 
Parameters: degrees An angle, in degrees 
Returns: The angle in radians 
® static final double E 
This constant is the value of e, the base of the natural logarithms. 
® static final double PI 
This constant is the value of z. 


Class java. lang.Nul1PointerException 


This exception is thrown when a program tries to use an object through a nu11 
reference. 


Class java. lang.NumberFormatException 


This exception is thrown when a program tries to parse the numerical value of a 
string that is not a number. 


Class java.lang.Object 


® protected Object clone() 
This constructs and returns a shallow copy of this object whose instance variables are 
copies of the instance variables of this object. If an instance variable of the object is an 
object reference itself, only the reference is copied, not the object itself. However, if the 
class does not implement the Cloneable interface, a CloneNotSupportedException is 
thrown. Subclasses should redefine this method to make a deep copy. 
Returns: A copy of this object 

® boolean equals(Object other) 
This method tests whether this and the other object are equal. This method tests only 
whether the object references are to the same object. Subclasses should redefine this 
method to compare the instance variables. 
Parameters: other The object with which to compare 
Returns: true if the objects are equal, false otherwise 

® void notifyQ 


This method notifies one of the threads that is currently on the wait list for the lock of 
this object. 
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void notifyAl1(Q 

This method notifies all of the threads that are currently on the wait list for the lock of 
this object. 

String toString 

This method returns a string representation of this object. This method produces only the 
class name and locations of the objects. Subclasses should redefine this method to print 
the instance variables. 

Returns: A string describing this object 

void wait() 

This method blocks the currently executing thread and puts it on the wait list for the lock 
of this object. 


Interface java. 1lang.Runnable 


void runc) 


This method should be overridden to define the tasks to be carried out when this 
runnable is executed. 


Class java. lang.RuntimeException 


This is the superclass for all unchecked exceptions. 


Class java.lang.String 


int compareTo(String other) 

This method compares this string and the other string lexicographically. 

Parameters: other The other string to be compared 

Returns: A value less than 0 if this string is lexicographically less than the other, 0 if the 
strings are equal, and a value greater than 0 otherwise. 

boolean equals(String other) 

boolean equalsIgnoreCase(String other) 


These methods test whether two strings are equal, or whether they are equal when letter 
case is ignored. 


Parameters: other The other string to be compared 
Returns: true if the strings are equal 
static String format(String format, Object... values) 


This method formats the given string by substituting placeholders that start with % with 
the given values. 


Parameters: format The string with the placeholders 
values The values to be substituted for the placeholders 
Returns: The formatted string, with the placeholders replaced by the given values 
int lengthQ 
This method returns the length of this string. 
Returns: The count of characters in this string 
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© String replace(String match, String replacement) 
This method replaces matching substrings with a given replacement. 
Parameters: match The string whose matches are to be replaced 
replacement The string with which matching substrings are replaced 


Returns: A string that 1s identical to this string, with all matching substrings replaced by 
the given replacement 


® String substring(int begin) 
® String substring(int begin, int pastEnd) 
These methods return a new string that is a substring of this string, made up of all charac- 


ters starting at position begin and up to either position pastEnd - 1, if it is given, or the 
end of the string. 


Parameters: begin The beginning index, inclusive 
pastEnd The ending index, exclusive 
Returns: The specified substring 
® String toLowerCase() 


This method returns a new string that consists of all characters in this string converted to 
lowercase. 


Returns: A string with all characters in this string converted to lowercase 
® String toUpperCase() 


This method returns a new string that consists of all characters in this string converted to 
uppercase. 


Returns: A string with all characters in this string converted to uppercase 


Class java. 1lang.System 
® static void arraycopy( 
Object from, int fromStart, Object to, int toStart, int count) 


This method copies values from one array to the other. (The array parameters are of type 
Object because you can convert an array of numbers to an Object but not to an Object[].) 


Parameters: from The source array 
fromStart Start position in the source array 
to The destination array 
toStart Start position in the destination data 
count The number of array elements to be copied 
® static long currentTimeMillis() 


This method returns the difference, measured in milliseconds, between the current time 
and midnight, Universal Time, January 1, 1970. 


Returns: The current time in milliseconds 
® static void exit(int status) 

This method terminates the program. 

Parameters: status Exit status. A nonzero status code indicates abnormal termination 
® static final InputStream in 


This object is the “standard input” stream. Reading from this stream typically reads 
keyboard input. 
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static final PrintStream out 


This object is the “standard output” stream. Printing to this stream typically sends output 
to the console window. 


Class java. lang. Thread 


boolean interrupted() 
This method tests whether another thread has called the interrupt method on the current 


thread. 

Returns: true if the thread has been interrupted 

static void sleepCint millis) 

This method puts the calling thread to sleep. 

Parameters: millis the number of millseconds to sleep 
void start() 

This method starts the thread and executes its run method. 


Class java. lang. Throwable 


This is the superclass of exceptions and errors. 

Throwable() 

This constructs a Throwable with no detail message. 

String getMessage() 

This method gets the message that describes the exception or error. 
Returns: The message 

void printStackTrace() 


This method prints a stack trace to the “standard error” stream. The stack trace contains a 
printout of this object and of all calls that were pending at the time it was created. 


Class java.math.BigDecimal 


BigDecimal (String value) 

This constructs an arbitrary-precision floating-point number from the digits in the given 
string. 

Parameters: value A string representing the floating-point number 

BigDecimal add(BigDecimal other) 

BigDecimal multiply(BigDecimal other) 

BigDecimal subtract(BigDecimal other) 

These methods return a BigDecimal whose value is the sum, difference, product, or 
quotient of this number and the other. 

Parameters: other The other number 

Returns: The result of the arithmetic operation 
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Class java.math.BigInteger 


BigInteger(String value) 

This constructs an arbitrary-precision integer from the digits in the given string. 
Parameters: value A string representing an arbitrary-precision integer 
BigInteger add(BigInteger other) 

BigInteger divide(BigInteger other) 

BigInteger mod(BigInteger other) 

BigInteger multiply(BigInteger other) 

BigInteger subtract(BigInteger other) 

These methods return a BigInteger whose value is the sum, difference, product, quotient, 
or remainder of this number and the other. 

Parameters: other The other number 

Returns: The result of the arithmetic operation 


Class java.net.HttpURLConnection 


int getResponseCode() 


This method gets the response status code from this connection. A value of HTTP_OK 
indicates success. 


Returns: The HTTP response code 

String getResponseMessage() 

This method gets the response message of this connection’s HTTP request. 
Returns: The message, such as "OK" or "File not found" 

Static int HTTP_OK 

This response code indicates a successful fulfillment of the request. 


Class java.net.ServerSocket 


® ServerSocket(int port) 


This constructs a server socket that listens to the given port. 
Parameters: port The port number to listen to 
Socket accept() 


This method waits for a client to connect to the port to which this server socket listens. 
When a connection occurs, the method returns a socket through which the server can 
communicate with the client. 


Returns: The socket through which the server can communicate with the client 
void close() 
This method closes the server socket. Clients can no longer connect. 
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Class java.net.Socket 


Socket(String host, int port) 
This constructs a socket that connects to a server. 
Parameters: host The host name 

port The port number to connect to 
void close() 
This method closes the connection with the server. 
InputStream getInputStream() 


This method gets the input stream through which the client can read the information that 
the server sends. 


Returns: The input stream associated with this socket 
OutputStream getOutputStream() 


This method gets the output stream through which the client can send information to the 
server. 


Returns: The output stream associated with this socket 


Class java.net.URL 


URL(String s) 

This constructs an URL object from a string containing the URL. 

Parameters: s The URL string, such as "http://java.sun.com/index.htm1" 
InputStream openConnection() 


This method gets the input stream through which the client can read the information that 
the server sends. 


Returns: The input stream associated with this URL 


Class java.net.URLConnection 


URLConnection(URL u) 

This constructs an URLConnection object from an URL object. 

Parameters: u The resource to which you intend to connect 

int getContentLength() 

This method gets the value of the content-1ength header of this URL connection. 
Returns: The number of bytes in the content that the server is sending 

String getContentType() 

This method gets the value of the content-type header of this URL connection. 
Returns: The MIME type of the content that the server is sending, such as "text/plain" 
or "image/gif" 

InputStream getInputStream() 


This method gets the input stream through which the client can read the information that 
the server sends. 


Returns: The input stream associated with this URL 
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® void setIfModifiedSince(Date d) 


This method instructs the connection to request that the server send data only if the De 

content has been modified since a given date. a 

Parameters: d The modification date a 
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Interface java.sql .Connection 


© void close() 
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This method closes the connection with the database. 
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® void commit() 
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This method commits all database changes since the last call to commit or rollback. 
® Statement createStatement () 
This method creates a statement object, which can be used to issue database commands. 
Returns: A statement object 
® PreparedStatement prepareStatement(String command) 
This method creates a prepared statement for a SQL command that is issued repeatedly. 
Parameters: command The SQL command 
Returns: The statement object for setting parameters and executing the call 
® void rollback() 
This method abandons all database changes since the last call to commit or rol]back. 
® void setAutoCommit (boolean b) 
This method sets the auto commit mode. By default, it is true. If it is set to false, then 
transactions are indicated with calls to commit or rollback. Creates a prepared statement 
for a SQL command that is issued repeatedly. 
Parameters: command The SQL command 
b ‘The desired auto commit mode 


Class java.sql .DriverManager 
® static Connection getConnection(String url, String username, String password) 
This method obtains a connection to the database specified in the database URL. 
Parameters: url The database URL 
username ‘The database user name 
password The password for the database user 
Returns: A connection to the database 
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Interface java.sql.PreparedStatement 


® boolean execute() 
This method executes this prepared statement. 
Returns: true if the execution yielded a result set 
® ResultSet executeQuery() 
This method executes this prepared query. 
Returns: The query result 
© int executeUpdate() 
This method executes this prepared update command. 
Returns: The number of records affected by the update 
® void setDouble(int index, double value) 
This method sets a floating-point parameter for a call of this prepared statement. 
Parameters: index The parameter index (starting with 1) 
value The parameter value 
® void setInt(int index, int value) 
This method sets an integer parameter for a call of this prepared statement. 
Parameters: index The parameter index (starting with 1) 
value The parameter value 
® void setString(int index, String value) 
This method sets a string parameter for a call of this prepared statement. 
Parameters: index The parameter index (starting with 1) 
value The parameter value 


Interface java.sql .ResultSet 


® void close() 
This method closes the result set. 

® double getDouble(int column) 
This method returns the floating-point value at the cursor row and the given column. 
Parameters: column The column index (starting with 1) 
Returns: The data value 

© double getDouble(String columnName) 
This method returns the floating-point value at the cursor row and the given column. 
Parameters: columnName The column name 
Returns: The data value 

® int getIntCint column) 
This method returns the integer value at the cursor row and the given column. 
Parameters: column The column index (starting with 1) 
Returns: The data value 

® int getIint(String columnName) 
This method returns the integer value at the cursor row and the given column. 
Parameters: columnName The column name 
Returns: The data value 


APPENDIXC #8 The Java Library 1087 


ResultSetMetaData getMetaData() 
This method returns the meta data associated with this result set. 
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Returns: The meta data 

String getStringCint column) 

This method returns the value at the cursor row and the given column. ay 
Parameters: column The column index (starting with 1) a 
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Returns: The data value, as a string 
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String getString(String columnName) 

This method returns the value at the cursor row and the given column. 

Parameters: columnName The column name 

Returns: The data value, as a string 

boolean next() 

This method positions the cursor to the next row. You must call next once before calling 
any of the get methods to move the cursor to the first row. 


Returns: true if the cursor has been positioned on a row, false at the end of the result 
set 


Interface java.sql .ResultSetMetaData 


int getColumnCount () 

This method returns the number of columns of this result set. 
Returns: The number of columns 

int getColumnDisplaySize(int column) 


This method returns the number of characters that should be used to display the specified 
column in this result set. 


Parameters: column The column index (starting with 1) 

Returns: The number of characters that should be used to display this column 
String getColumnLabel (int column) 

This method returns the label for a column in this result set. 

Parameters: column The column index (starting with 1) 

Returns: The column label 


Class java.sql .SQLException 


This exception is thrown when a database error occurs. 


interface java.sql .Statement 


@ void close() 


This method closes this statement. 


® boolean execute(String command) 


This method executes a SQL command. 


Parameters: command The command to execute 
Returns: true if the execution yielded a result set 
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® ResultSet executeQuery(String command) 
This method executes a SQL query. 
Parameters: command The query command to execute 
Returns: The query result 
® int executeUpdate(String command) 
This method executes a SQL update command. 
Parameters: command The update command to execute 
Returns: The number of records affected by the update 
® ResultSet getResultSet(Q) 
This method gets the result of the last command. 
Returns: The query result from the last command 
© int getUpdateCount() 
This method gets the update count of the last command. 
Returns: The number of records affected by the last command 
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Class java. text.DateFormat 
® String format(Date aDate) 
This method formats a date. 


Parameters: aDate The date to format 
Returns: A string containing the formatted date 
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® static DateFormat getTimeInstance() 
This method returns a formatter that formats only the time portion of a date. 
Returns: The formatter object 

® void setTimeZone(TimeZone zone) 
This method sets the time zone to be used when formatting dates. 
Parameters: zone The time zone to use 
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Class java.util .ArrayList<E> 
@ ArrayListQ) 
This constructs an empty array list. 


e boolean add(E element) 


This method appends an element to the end of this array list. 
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Parameters: element The element to add 
Returns: true (This method returns a value because it overrides a method in the List 
interface.) 
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void add(int index, E element) 
This method inserts an element into this array list. 
Parameters: index Insert position 
element The element to insert 
E getCint index) 
This method gets the element at the specified position in this array list. 
Parameters: index Position of the element to return 
Returns: The requested element 
E remove(int index) 
This method removes the element at the specified position in this array list and returns it. 
Parameters: index Position of the element to remove 
Returns: The removed element 
E set(int index, E element) 
This method replaces the element at a specified position in this array list. 
Parameters: index Position of element to replace 
element Element to be stored at the specified position 
Returns: The element previously at the specified position 
int sizeQ 
This method returns the number of elements in this array list. 
Returns: The number of elements in this array list 


Class java.util .Arrays 


static int binarySearch(Object[] a, Object key) 
This method searches the specified array for the specified object using the binary search 
algorithm. The array elements must implement the Comparable interface. The array must 
be sorted in ascending order. 
Parameters: a The array to be searched 

key The value to be searched for 
Returns: The position of the search key, if it is contained in the array; otherwise, 
~index — 1, where index is the position where the element may be inserted 
Static void sort(Object[] a) 
This method sorts the specified array of objects into ascending order. Its elements must 
implement the Comparable interface. 
Parameters: a The array to be sorted 


Class java.util .Calendar 


int getCint field) 
This method returns the value of the given field. 
Parameters: One of Calendar. YEAR, Calendar .MONTH, Calendar .DAY_OF_MONTH, 


Calendar.HOUR, Calendar.MINUTE, Calendar. SECOND, or 
Calendar .MILLISECOND 
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Interface java.util .Collection<E> 


® boolean add(E element) 
This method adds an element to this collection. 
Parameters: element The element to add 
Returns: true if adding the element changes the collection 
® boolean contains(E element) 
This method tests whether an element is present in this collection. 
Parameters: element The element to find 
Returns: true if the element is contained in the collection 
® Iterator iterator() 


This method returns an iterator that can be used to traverse the elements of this 
collection. 


Returns: An object of a class implementing the Iterator interface 
© boolean remove(E element) 

This method removes an element from this collection. 

Parameters: element The element to remove 

Returns: true if removing the element changes the collection 
@ int size() 

This method returns the number of elements in this collection. 

Returns: The number of elements in this collection 


Class java.util .Collections 


® static <T> int binarySearch(List<T> a, T key) 


This method searches the specified list for the specified object using the binary search 
algorithm. The list elements must implement the Comparable interface. The list must be 
sorted in ascending order. 


Parameters: a The list to be searched 
key ‘The value to be searched for 


Returns: The position of the search key, if it is contained in the list; otherwise, 
—index — 1, where index is the position where the element may be inserted 


® static <T> void sort(T[] a) 


This method sorts the specified list of objects into ascending order. Its elements must 
implement the Comparable interface. 


Parameters: a The list to be sorted 


Interface java.util .Comparator<T> 


® int compare(T first, T second) 
This method compares the given objects. 
Parameters: first, second The objects to be compared 


Returns: A negative integer if the first object is less than the second, zero if they are 
equal, or a positive integer otherwise 
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Class java.util.Date 


® Date() 
This constructs an object that represents the current date and time. 


Class java.util .EventObject 

@ Object getSource() 
This method returns a reference to the object on which this event initially occurred. 
Returns: The source of this event 


Class java.util .GregorianCalendar 
® GregorianCalendar() 
This constructs a calendar object that represents the current date and time. 
® GregorianCalendar(int year, int month, int day) 
This constructs a calendar object that represents the start of the given date. 
Parameters: year,month, day The given date 


Class java.util .HashMap<K, V> 


® HashMap<K, V>(Q 
This constructs an empty hash map. 


Class java.util .HashSet<E> 


® HashSet<E>O 
This constructs an empty hash set. 


Class java.util .InputMismatchException 


This exception is thrown if the next available input item does not match the type of the 
requested item. 


Interface java.util .Iterator<E> 


®@ boolean hasNext(Q) 
This method checks whether the iterator is past the end of the list. 
Returns: true if the iterator is not yet past the end of the list 

® E— nextQ 


This method moves the iterator over the next element in the linked list. This method 
throws an exception if the iterator is past the end of the list. 


Returns: The object that was just skipped over 


® void remove() 
This method removes the element that was returned by the last call to next or previous. 
This method throws an exception if there was an add or remove operation after the last call 
to next or previous. 
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Class java.util.LinkedHashMap<K, V> 


® LinkedHashMap<K, V>Q 


This constructs an empty linked hash map. The iterator of a linked hash map visits the 
entries in the order in which they were added to the map. 


Class java.util.LinkedList<E> 


® void addFirst(E element) 

® void addLast(E element) 
These methods add an element before the first or after the last element in this list. 
Parameters: element The element to be added 

® E getFirstQ) 

® E getLast(Q) 
These methods return a reference to the specified element from this list. 
Returns: The first or last element 

© E removeFirst() 

® E removeLast() 
These methods remove the specified element from this list. 
Returns: A reference to the removed element 


Interface java.util.List<E> 


@ ListIterator<E> listIterator() 
This method gets an iterator to visit the elements in this list. 
Returns: An iterator that points before the first element in this list 


Interface java.util .ListIterator<E> 


Objects implementing this interface are created by the listIterator methods of list 
classes. 


® void add(E element) 


This method adds an element after the iterator position and moves the iterator after the 
new element. 


Parameters: element The element to be added 

® boolean hasPrevious() 
This method checks whether the iterator is before the first element of the list. 
Returns: true if the iterator is not before the first element of the list 

® E— previous() 


This method moves the iterator over the previous element in the linked list. This method 
throws an exception if the iterator is before the first element of the list. 


Returns: The object that was just skipped over 
® void set(E element) 


This method replaces the element that was returned by the last call to next or previous. 
This method throws an exception if there was an add or remove operation after the last 
call to next or previous. 


Parameters: element The element that replaces the old list element 
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Interface java.util .Map<K, V> 


V getCK key) 

Gets the value associated with a key in this map. 

Parameters: key The key for which to find the associated value 

Returns: The value associated with the key, or nu11 if the key is not present in the table 
Set<K> keySetQ 

This method returns all keys in the table of this map. 

Returns: A set of all keys in the table of this map 

V put(K key, V value) 

This method associates a value with a key in this map. 


Parameters: key The lookup key 
value The value to associate with the key 
Returns: The value previously associated with the key, or nu11 if the key was not 
present in the table 
V remove(K key) 
This method removes a key and its associated value from this map. 
Parameters: key The lookup key 
Returns: The value previously associated with the key, or nu11 if the key was not 
present in the table 


Class java.util .NoSuchElementException 


This exception is thrown if an attempt is made to retrieve a value that does not exist. 


Class java.util .PriorityQueue<E> 


PriorityQueue<E>() 


This constructs an empty priority queue. The element type E must implement the 
Comparable interface. 


E remove() 
This method removes the smallest element in the priority queue. 
Returns: The removed value 


Class java.util.Properties 


® String getProperty(String key) 


This method gets the value associated with a key in this properties map. 
Parameters: key The key for which to find the associated value 
Returns: The value, or nu11 if the key is not present in the table 


void load(InputStream in) 
This method loads a set of key/value pairs into this properties map from a stream. 


Parameters: in The stream from which to read the key/value pairs (it must be a 
sequence of lines of the form key=value) 
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Class java.util .Random 


Random () 
This constructs a new random number generator. 
double nextDouble() 


This method returns the next pseudorandom, uniformly distributed floating-point 
number between 0.0 (inclusive) and 1.0 (exclusive) from this random number generator’s 
sequence. 


Returns: The next pseudorandom floating-point number 

int nextInt(int n) 

This method returns the next pseudorandom, uniformly distributed integer between 0 
(inclusive) and the specified value (exclusive) drawn from this random number generator’s 
sequence. 

Parameters: n Number of values to draw from 

Returns: The next pseudorandom integer 


Class java.util .Scanner 


Scanner (InputStream in) 

Scanner(Reader in) 

These construct a scanner that reads from the given input stream or reader, 
Parameters: in The input stream or reader from which to read 

void close() 

This method closes this scanner and releases any associated system resources. 
boolean hasNext() 

boolean hasNextDoub1e() 

boolean hasNextInt() 

boolean hasNextLine() 


These methods test whether it is possible to read any non-empty string, a floating-point 
value, an integer, or a line, as the next item. 


Returns: true if it is possible to read an item of the requested type, false otherwise 
(either because the end of the file has been reached, or because a number type was tested 
and the next item is not a number) 


String next() 
double nextDouble() 
int nextInt() 
String nextLineQ) 


These methods read the next whitespace-delimited string, floating-point value, integer, or 
line. 


Returns: The value that was read 


Interface java.util .Set<E> 


This interface describes a collection that contains no duplicate elements. 
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Class java.util .TimeZone 

® static String[] getAvailableIDs() 
This method gets the supported time zone IDs. 
Returns: An array of ID strings 

® static TimeZone getTimeZone(String id) 
This method gets the time zone for a time zone ID. 


Parameters: id The time zone ID, such as "America/Los_Angeles" 
Returns: The time zone object associated with the ID, or nu11 if the ID is not supported 


Class java.util.TreeMap<K, V> 


® TreeMap<K, V>Q 


This constructs an empty tree map. The iterator of a TreeMap visits the entries in sorted 
order. 


Class java.util .TreeSet<E> 


® TreeSet<E>(Q) 
This constructs an empty tree set. 
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Interface java.util .concurrent.locks.Condition 
® void await() 
This method blocks the current thread until it is signalled or interrupted. 
® void signal () 
This method unblocks one thread that is waiting on this condition. 
® void signalAl!l(Q 
This method unblocks all threads that are waiting on this condition. 


Interface java.util .concurrent. locks. Lock 


® void lock() 


This method causes the current thread to acquire this lock. The thread blocks if the lock is 
not available. 
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® Condition newCondition() 
This method creates a new condition object for this lock. 
Returns: The condition object 

® void unlock() 


This method causes the current thread to relinquish this lock. 


Class java.util .concurrent. locks.ReentrantLock 


® ReentrantLock() 


This constructs a new reentrant lock. 
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Class java.util. logging.Level 


Static final int ALL 

This value indicates logging of all messages. 
Static final int INFO 

This value indicates informational logging. 
static final int NONE 

This value indicates logging of no messages. 


Class java.util. logging.Logger 


Static Logger getLogger(String id) 

This method gets the logger for a given ID. Use the ID "global" to get the default global 
logger. 

Parameters: id the logger ID suchas "global" or "com.mycompany.mymodule" 
Returns: The logger with the given ID 

void info(String message) 

This method logs an informational message. 

Parameters: message The message to log 

void setLevel(Level aLevel) 


This method sets the logging level. Logging messages with a lesser severity than the 
current level are ignored. 


Parameters: alevel The minimum level for logging messages 


Class javax.swing.AbstractButton 


void addActionListener (ActionListener listener) 
This method adds an action listener to the button. 
Parameters: listener The action listener to be added 
boolean isSelected() 

This method returns the selection state of the button. 
Returns: true if the button is selected 

void setSelected(boolean state) 


This method sets the selection state of the button. This method updates the button but 
does not trigger an action event. 


Parameters: state true to select, false to deselect 
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Class javax.swing.ButtonGroup 
® void add(AbstractButton button) 
This method adds the button to the group. 
Parameters: button The button to add 


Class javax.swing.ImageIcon 


® ImageIcon(String filename) 
This constructs an image icon from the specified graphics file. 
Parameters: filename A string specifying a file name 


Class javax.swing.JButton 

© J3Button(String label) 
This constructs a button with the given label. 
Parameters: label The button label 


Class javax. swing. JCheckBox 


® JCheckBox(String text) 


This constructs a check box, having the given text, initially deselected. (Use the 
setSelected() method to make the box selected; see the javax. swing.AbstractButton 
class.) 


Parameters: text The text displayed next to the check box 


Class javax. swing. JComboBox 


® JComboBox() 
This constructs a combo box with no items. 

® void addItem(Object item) 
This method adds an item to the item list of this combo box. 
Parameters: item The item to add 

® Object getSelectedItem() 
This method gets the currently selected item of this combo box. 
Returns: The currently selected item 

® boolean isEditable() 


This method checks whether the combo box is editable. An editable combo box allows 
the user to type into the text field of the combo box. 


Returns: true if the combo box is editable 
® void setEditable(boolean state) 
This method is used to make the combo box editable or not. 


Parameters: state true to make editable, false to disable editing 
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Class javax. swing. JComponent 


® protected void paintComponent(Graphics g) 


Override this method to paint the surface of a component. Your method needs to call 
super.paintComponent(g). 


Parameters: g The graphics context used for drawing 
® void setBorder(Border b) 

This method sets the border of this component. 

Parameters: b The border to surround this component 
© void setFont(Font f) 

Sets the font used for the text in this component. 

Parameters: f A font 


Class javax.swing.JFileChooser 


@ 3FileChooser () 
This constructs a file chooser. 

© File getSelectedFile() 
This method gets the selected file from this file chooser. 
Returns: The selected file 

© int showOpenDialog(Component parent) 
This method displays an “Open File” file chooser dialog box. 
Parameters: parent The parent component or nul] 


Returns: The return state of this file chooser after it has been closed by the user: 
either APPROVE_OPTION or CANCEL_OPTION. If APPROVE_OPTION is returned, call 
getSelectedFile() on this file chooser to get the file 


® int showSaveDialog(Component parent) 
This method displays a “Save File” file chooser dialog box. 
Parameters: parent The parent component or null 


Returns: The return state of the file chooser after it has been closed by the user: 
either APPROVE_OPTION or CANCEL_OPTION 


Class javax.swing. JFrame 


® void setDefaultCloseOperation(int operation) 
This method sets the default action for closing the frame. 


Parameters: operation The desired close operation. Choose among 
DO_NOTHING_ON_CLOSE, HIDE_ON_CLOSE (the default), DISPOSE_ON_CLOSE, 
or EXIT_ON_CLOSE 


® void setJMenuBar(JMenuBar mb) 

This method sets the menu bar for this frame. 

Parameters: mb The menu bar. If mb is nu11, then the current menu bar is removed 
® static final int EXIT_ON_CLOSE 

This value indicates that when the user closes this frame, the application is to exit. 
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Class javax.swing.JLabel 

® JLabel (String text) 

® JLabel (String text, int alignment) 
These containers create a JLabel instance with the specified text and horizontal alignment. 
Parameters: text The label text to be displayed by the label 


alignment One of SwingConstants.LEFT, SwingConstants.CENTER, or 
SwingConstants.RIGHT 


Class javax.swing.JMenu 


@ JjMenu() 
This constructs a menu with no items. 

® jMenuItem add(JMenuItem menulItem) 
This method appends a menu item to the end of this menu. 
Parameters: menuItem The menu item to be added 
Returns: The menu item that was added 


Class javax.swing. JMenuBar 


® JMenuBar () 
This constructs a menu bar with no menus. 
® jMenu add(jJMenu menu) 
This method appends a menu to the end of this menu bar. 
Parameters: menu The menu to be added 
Returns: The menu that was added 


Class javax.swing.JMenultem 


@ jMenultem(String text) 
This constructs a menu item. 
Parameters: text The text to appear in the menu item 


Class javax. swing. JOptionPane 


® static String showInputDialog(Object prompt) 
This method brings up a modal input dialog box, which displays a prompt and waits for 
the user to enter an input in a text field, preventing the user from doing anything else in 
this program. 
Parameters: prompt The prompt to display 
Returns: The string that the user typed 
® static void showMessageDialog(Component parent, Object message) 
This method brings up a confirmation dialog box that displays a message and waits for the 
user to confirm it. 
Parameters: parent The parent component or nul] 
message The message to display 
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Class javax.swing. JPanel 


This class is a component without decorations. It can be used as an invisible container for 
other components. 


Class javax. swing. JRadioButton 


® JRadioButton(String text) 


This constructs a radio button having the given text that is initially deselected. (Use the 
setSelected() method to select it; see the javax.swing.AbstractButton class.) 


Parameters: text The string displayed next to the radio button 


Class javax.swing.JScrol1Pane 


® J3ScrollPane(Component c) 
This constructs a scroll pane around the given component. 
Parameters: c The component that is decorated with scroll bars 


Class javax.swing.JSlider 


® 3SliderCint min, int max, int value) 
This constructor creates a horizontal slider using the specified minimum, maximum, 
and value. 


Parameters: min The smallest possible slider value 
max ‘The largest possible slider value 
value The initial value of the slider 

® void addChangeListener(ChangeListener listener) 

This method adds a change listener to the slider. 

Parameters: listener The change listener to add 

® int getValue() 

This method returns the slider’s value. 

Returns: The current value of the slider 


Class javax.swing.JTextArea 
® JTextArea() 
This constructs an empty text area. 
® JTextArea(int rows, int columns) 
This constructs an empty text area with the specified number of rows and columns. 
Parameters: rows The number of rows 
columns The number of columns 
® void append(String text) 
This method appends text to this text area. 
Parameters: text The text to append 
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Class javax.swing.JTextField 


® IJTextField() 
This constructs an empty text field. 

@ JTextField(int columns) 
This constructs an empty text field with the specified number of columns. 
Parameters: columns The number of columns 


Class javax.swing. Timer 


® Timer(int millis, ActionListener listener) 


This constructs a timer that notifies an action listener whenever a time interval has 
elapsed. 


Parameters: millis The number of milliseconds between timer notifications 
listener The object to be notified when the time interval has elapsed 
® void start() 
This method starts the timer. Once the timer has started, it begins notifiying its listener. 
® void stop() 
This method stops the timer. Once the timer has stopped, it no longer notifies its listener. 


Class javax.swing.border.EtchedBorder 


® EtchedBorder() 
This constructor creates a lowered etched border. 


Class javax.swing.border.TitledBorder 


® TitledBorder(Border b, String title) 
This constructor creates a titled border that adds a title to a given border. 
Parameters: b The border to which the title is added 
title The title the border should display 


Class javax.swing.event.ChangeEvent 


Components such as sliders emit change events when they are manipulated by the user. 


Interface javax.swing.event.ChangeListener 


® void stateChanged(ChangeEvent e) 
This event is called when the event source has changed its state. 


Parameters: e A change event 
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Class javax.swing. text. JTextComponent 


String getText(Q) 
This method returns the text contained in this text component. 


Returns: The text 

boolean isEditable() 

This method checks whether this text component is editable. 
Returns: true if the component is editable 

void setEditable(boolean state) 

This method is used to make this text component editable or not. 
Parameters: state true to make editable, false to disable editing 
void setText(String text) 


This method sets the text of this text component to the specified text. If the text is empty, 
the old text is deleted. 


Parameters: text The new text to be set 


Class javax.xml .parsers.DocumentBuilder 


® Document newDocument () 
This constructs a new document object. 


Returns: An empty document 

Document parse(File in) 

This method parses an XML document in a file. 
Parameters: in The file containing the document 
Returns: The parsed document 

Document parse(InputStream in) 

This method parses an XML document in a stream. 
Parameters: in The stream containing the document 
Returns: The parsed document 
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Class javax.xml.parsers .DocumentBuilderFactory 


DocumentBui |lder newDocumentBuilder() 

This method creates a new document builder object. 
Returns: The document builder 

Static DocumentBuilderFactory newInstance() 

This method creates a new document builder factory object. 
Returns: The document builder factory object 

void setIgnoringElementContentWhitespace(boolean b) 


This method sets the parsing mode for ignoring white space in element content for all 
document builders that are generated from this factory. 


Parameters: b true if white space should be ignored 
void setValidating(boolean b) 


This method sets the validation mode for all document builders that are generated from 
this factory. 


Parameters: b true if documents should be validated during parsing 


Interface javax.xml.xpath. XPath 


String evaluate(String path, Object context) 
This method evaluates the given path expression in the given context. 
Parameters: path An XPath expression 


context The starting context for the evaluation, such as a document, 
node, or node list 
Returns: The result of the evaluation 


Class javax.xml .xpath. XPathExpressionException 


This exception is thrown when an XPath expression cannot be evaluated. 


Class javax.xml.xpath. XPathFactory 


static XPathFactory newInstance() 

This method returns a factory instance that can be used to construct XPath objects. 
Returns: An XPathFactory instance 

XPath newXPath() 

This method returns an XPath object that can be used to evaluate XPath expressions. 
Returns: An XPath object 
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Interface org.w3c.dom.Document 


® Element createElement(String tagName) 


This method creates a new document element with a given tag. 
Parameters: tagName The name of the XML tag 
Returns: The created element 
® Text createTextNode(String text) 
This method creates a text node with the given text. 
Parameters: text The text for the text node 
Returns: The created text node 
® DOMImplementation getImplementation() 
This method returns the DOMImplementation object associated with this document. 


Interface org.w3c.dom.DOMConfiguration 


® void setParameter(String name, Object value) 
This method sets the value of a configuration parameter. 


Parameters: name The name of the parameter to set 
value The new value or nu11 to unset the parameter 


Interface org.w3c.dom.DOMImplementation 


® Object getFeature(String feature, String version) 


This method gets an object that implements a specialized API (such as loading and saving 
of DOM trees). 


Parameters: feature The feature version (such as “LS”) 
version ‘The version number (such as “3.0”) 
Returns: The feature object 


Interface org.w3c.dom.Element 


® String getAttribute(String attributeName) 
This method returns the value of a given attribute. 
Parameters: attributeName The name of the XML attribute 


Returns: The attribute value, or the empty string "" if that attribute does not exist for 
this element 


® void setAttribute(String name, String value) 
This method sets the value of a given attribute. 


Parameters: name The name of the XML attribute 
value ‘The desired value of the XML attribute 


Interface org.w3c.dom. Text 


This interface describes a node that contains the textual content of an XML element. 
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Interface org.w3c.dom.1s.DOMImplementationLs 


® LSSerializer createLSSerializer() 
This method creates a serializer object that can be used to convert a DOM tree to a 
string or stream. 
Returns: The serializer object 


M* 
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Interface org.w3c.dom.1s.LSSerializer 


® DOMConfiguration getDomConfig(Q) 
This method gets the configuration object that allows customization of the serializer 
behavior. 

® String writeToString(Node root) 
This method converts the DOM tree starting at the given node to a string. 
Parameters: node The root node of the tree 
Returns: The string representation of the tree 


Appendix 


Java Syntax 
summary 


In this syntax summary, we use a monospaced font for actual Java keywords and 
tokens such as while. An italic font denotes language constructs such as condition or 
variable. Items enclosed in brackets [ ] are optional. Items separated by vertical bars 
| are alternatives. Do not include the brackets or vertical bars in your code! 

The summary reflects the parts of the Java language that were covered in this 
book. For a full overview of the Java syntax, see [1]. 

As always, please be careful to distinguish an ellipsis . . . from the ... token. 
The latter appears twice in this appendix in the “variable parameters” discussion in 
the “Methods” section. 


A type is a primitive type or a reference type. The primitive types are 


e The numeric types int, long, short, char, byte, Float, double 
e The boolean type 


‘The reference types are 


e Classes such as Stri ng Or Employee 
e Enumerated types such as enum Sex { FEMALE, MALE } 
e Interfaces such as Comparable 


e Array types such as Employee[],or int[][] 
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Local variable declarations have the form 

[final] Type variableName [= initializer]; 
Examples: 

int Ay. 

double x = 0; 

String harry = "Harry Handsome"; 

Rectangle box = new Rectangle(5, 10, 20, 30); 

inti] a={1, 4, 9, 16, 25 }; 
The variable name consists only of letters, numbers, and underscores. It must begin 
with a letter or underscore. Names are case-sensitive: totalscore, TOTALSCORE, and 
totalScore are three different variables. 

The scope of a local variable extends from the point of its definition to the end of 
the enclosing block. 

A variable that is declared as final can have its value set only once. 

Instance variables will be discussed under “Classes”. 


sees Expr essions saad 5 een nN oe eee on Re Pe ce eee LS ey ee A sey ea ea 


An expression is a variable, a method call, or a combination of subexpressions joined 
by operators. Examples are: 


x 

Math.sin(x) 

x + Math.sin(x) 

x * Cl + Math.sin(x)) 
X++ 


y 
x == y && (z > 0 || w> 0) 


p.X 
e.getSalary( 


v[i] 

Operators can be unary, binary, or ternary. A unary operator acts on a single 
expression, such as x++. A binary operator combines two expressions, such as x + y. 
A ternary operator combines three expressions. Java has one ternary operator, ? : 
(see Advanced Topic 5.1). 

Unary operators can be prefix or postfix. A prefix operator is written before the 
expression on which it operates, as in -x. A postfix operator is written after the 
expression on which it operates, such as x++. 

Operators are ranked by precedence levels. Operators with a higher precedence 
bind more strongly than operators with a lower precedence. For example, * has a 
higher precedence than +,so x + y * zis the same asx + (y * z), even though the + 
comes first. 
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Most operators are left-associative. That is, operators of the same precedence are 
evaluated from the left to the right. For example, x - y + z is interpreted as (x - y) 
+ z,notx - (y + z). The exceptions are the unary prefix operators and the assign- 
ment operator which are right-associative. For example, z = y = Math.sin(x) means 
the same as z = (y = Math.sin(x)). 

Appendix E has a list of all Java operators. 


The syntax for a class is 


[public] [abstract|final] class ClassName 
[extends SuperClassName] 
[implements InterfaceName,, InterfaceName, . . «| 


{ 
feature, 
feature 
} 
Each feature is either a declaration of the form 
modifiers constructor|method|field|class 
or an initialization block 
[static] { body } 


See the section “Constructors” for more information about initialization blocks. 
Potential modifiers include public, private, protected, static, and final. 
A constructor has the form 


ClassName(parameter,;, parametery, . . -) 
[throws ExceptionType,, ExceptionIyper, . . «| 
body 
} 
A method has the form 
| Type methodName (parameter,, parameter, . . «) 
| [throws ExceptionType,, ExceptionTyper, . . «] 
body 
i 


An abstract method has the form 

abstract Type methodName(parameter,, parameterz, . . -)} 
A field declaration has the form 

Type variableName [= initializer]; 
Here is an example: 


public class Point 


{ 


1110 APPENDIXD «# Java Syntax Summary 


public Point( 


{ 
x = 0; y = 0; 
; 
public PointCdouble xx, double yy) 
{ 
X = XX; Y = YY; 
} 
public double getX() 
{ 
return x; 
} 
public double getY() 
{ 
return y; 
} 


private double x; 
private double y; 
} 
A class can have both instance fields and static fields. Each object of the class has a 
separate copy of the instance fields. There is only one per-class copy of the static 
fields. 
A class that is declared as abstract cannot be instantiated. That is, you cannot 
construct objects of that class. 
A class that is declared as final cannot be extended. 


The syntax for an interface is 
[public] interface InterfaceName 
; [extends InterfaceName,, InterfaceNamez, . . «| 
feature, 
feature 
} 


Each feature has the form 
modifiers method| field 


Potential modifiers are public, static, final. However, modifiers are never neces- 
sary because methods are automatically public and fields are automatically public 
Static final. 

A method declaration has the form 


Type methodName(parameter,, parameterz, . . .)3 
A field declaration has the form 


Type variableName = initializer; 
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Here 1s an example: 


public interface Measurable 


{ 

int getMeasure(); 

tnt CM_PER_INCH = 2.54; 
} 


The syntax for an enumerated type is 


[public] enum EnumeratedTypeName 
{ 
constant,, constant», 
feature, 
feature 


} 


Each constant 1s a constant name, followed by optional construction parameters. 
constantName|(parameter,, parameter>, . . -)] 


The semicolon after the constants is only required if the enumeration defines addi- 
tional features. An enumeration can have the same features as a class. Each feature 
has the form 


modifiers method| field 


Potential modifiers are public, static, final. 
Here are two examples: 


public enum Suit { HEARTS, DIAMONDS, SPADES, CLUBS }; 
public enum Card 
{ 

TWO(2), THREEC3), FOURC4), FIVE(5), SIX(6), 
SEVENC7), EIGHT(8), NINEC9), TENC10), 
JACKC10), QUEENC10), KINGC10), ACEC11); 

public void CardCint aValue) { value = aValue; } 

public int getValue(Q) { return value; } 

private int value; 


_ Methods 


tnhOdgs Y= 


A method definition has the form 


modifiers Type methodName(parameter,, parametery, . . ., parameter,) 
[throws ExceptionType,, ExceptionType,, . . «| 
body 


} 
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The return type Type is any Java type, or the special type void to indicate that the 
method returns no value. 
Each parameter has the form 


[final] Type parameterName 
A method has variable parameters if the last parameter has the special form 
Type... parameterName 


Such a method can be called with a sequence of values of the given type of any 
length. The parameter variable with the given name is an array of the given type that 
holds the parameter values. For example, the method 


public static double sum(double... values) 
{ 
double s = QO; 
for (double v : values) S=S + VV; 
return s; 
} 


can be called as 
double result = sum(1, -2.5, 3.14); 


In Java, all parameters are passed by value. Each parameter is a local variable whose 
scope extends to the end of the method body. It is initialized with a copy of the 
value supplied in the call. That value may be a primitive type or a reference type. If 
it is a reference type, invoking a mutator on the reference will modify the object 
whose reference has been passed to the method. 

Changing the value of the parameter variable has no effect outside the method. 
Tagging the parameter as final disallows such a change altogether. This is com- 
monly done to allow access of the parameter from an inner class defined in the 
method. 

Java distinguishes between instance methods and static methods. Instance meth- 
ods have a special parameter, the implicit parameter, supplied in the method call 
with the syntax 


implicit Parameter Value.methodName (parameter Value, , parameterValuey, . . .) 
Example: 
harry.setSalary (30000) 


The type of the implicit parameter must be the same as the type of the class contain- 
ing the method definition. A static method does not have an implicit parameter. 

In the method body, the this variable is initialized with a copy of the implicit 
parameter value. Using a field name without qualification means to access the field 
of the implicit parameter. For example, 


public void setSalary(double s) 
{ 


} 


salary = s; // ue, this.salary = 5s 
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By default, methods are dynamically bound. The virtual machine determines the 
class to which the implicit parameter object belongs and invokes the method 
defined in that class. However, if a method is invoked on the special variable super, 
then the method defined in the superclass is invoked on this. For example, 


public class MyPanel extends JPanel 


public void paintComponent(Graphics g) 
super.paintComponent(g) ; 
// Calls JPanel.paintComponent 
een 
} 


The return statement causes a method to exit immediately. If the method type is not 
void, you must return a value. The syntax is 


return [value]; 
For example, 


public double getSalary( 
{ 


} 
A method can call itself. Such a method is called recursive: 


return salary; 


public static int factorial(int n) 


{ 
if Cn <= 1) return 1; 
return n * factorial(n - 1); 


puna ele reenneenrcnanmeenanae 


A constructor definition has the form 


modifiers ClassName(parameter,;, parameter), . . «) 
[throws ExceptionIype,, ExceptionTyper, . . «| 


body 
} 


You invoke a constructor to allocate and construct a new object with a new 
expression 


new ClassName(parameterValue,, parameterValue), . . .) 


A constructor can call the body of another constructor of the same class with the 
syntax 


this(parameterValue,, parameterValuey, . . .) 
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For example, 


public Employee() 
{ 


} 


It can call a constructor of its superclass with the syntax 


EHTS 5.03 


super (parameterValue,, parameterValue), . . «) 


The call to this or super must be the first statement in the constructor. 
Arrays are constructed with the syntax 


new ArrayType [ = { initializer,, initializer,, . . . }] 
For example, 

new int[] = {1, 4, 9, 16, 25 } 
When an object is constructed, the following actions take place: 
e All fields are initialized with 0, false, or null. 


e The initializers and initialization blocks are executed in the order in which they 
are declared. 


e The body of the constructor is invoked. 
When a class is loaded, the following actions take place: 


e All static fields are initialized with 0, false, or null. 


e The initializers of static fields and static initialization blocks are executed in the 
order in which they are declared. 
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A statement is one of the following: 


e An expression followed by a semicolon 
e A branch or loop statement 

e A return statement 

e A throw statement 


e A block, that is, a group of variable declarations and statements enclosed in 
braces {. . .} 


e Atry block 


Java has two branch statements (if and switch), three loop statements (while, for, 
and do), and two mechanisms for nonlinear control flow (break and continue). 
The if statement has the form 


if (condition) statement, [else statementy| 
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It the condition is true, then the first statement is executed. Otherwise, the second 
statement is executed. 
The switch statement has the form 


switch (expression) 


{ 
group,: 
group) 
[default: 
statement 
statement) 
| 
$ 


Where each group has the form 


case constant, 
case constant) 


statement, 
statement) 


The expression must be an integer or an enumerated type. Depending on its value, 
control is transferred to the first statement following the matching case label, or to 
the first statement following the defau1t label if none of the case labels match. Exe- 
cution continues with the next statement until a break or return statement is 
encountered, an exception is thrown, or the end of the switch is reached. Execution 
skips over any case labels. 

The while loop has the form 


while (condition) statement 


The statement is executed while the condition is true. 
The for loop has the form 


for CinitExpression|variableDeclaration ; 
condition 3 
updateExpression;, updateExpressiony, . . .) 
statement 


The initialization expression or the variable declaration are executed once. While 
the condition remains true, the loop statement and the updateExpressions are exe- 
cuted. Examples: 
for (i = 0; 71 < 10; i++) 
sum = sum + 1; 
for Cint 1 = 0, j = 9; 71 < 10; i++, j--) 
alj] = bli]; 
The enhanced for loop or “for each” loop has the form 


for (Type variable : array|iterableObject) 
statement 
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When this loop traverses an array, it is equivalent to 


for Cint 1 = 0; 7 < array.length; i++) 


Type variable = array[il; 
statement 
} 
Otherwise, the iterableObject must belong to a class that implements the Iterable 
interface. Then the loop is equivalent to 


Iterator i = zterableObject.iterator(); 
while (i.hasNext()) 


Type variable = i.nextQ; 
statement 


} 
The do loop has the form 


do statement while (condition) ; 


The statement is repeatedly executed until the condition is no longer true. In con- 
trast to a while loop, the statement of a do loop is executed at least once. 

The break statement exits the innermost enclosing while, do, for, or switch state- 
ment (not counting if or block statements). 

Any statement (including if and block statements) can be tagged with a label: 


label: statement 
The labeled break statement 
break label; 


exits the labeled statement. 

The continue statement skips past the end of the statement part of a while, do, or 
for loop. In the case of the while or do loop, the loop condition is executed next. In 
the case of the for loop, the updateExpressions are executed next. 

The labeled continue statement 


continue label: 


skips past the end of the statement part of a while, do, or for loop with the matching 
label. 


The throw statement 
throw expression; 


abruptly terminates the current method and resumes control inside the innermost 
matching catch clause of a surrounding try block. The expression must evaluate to a 
reference to an object of a subclass of Throwable. 
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The try statement has the form 


try tryBlock 
[catch (ExceptionType, exceptionVariable,) catchBlock, 
catch (ExceptionType, exception Variable,) catchBlock 


od 
[finally finallyBlock] 


e The try statement must have at least one catch or finally clause. 


e All blocks are block statements in the usual sense, that is, { . . . }-delimited 
statement sequences. 


The statements in the tryBlock are executed. If one of them throws an exception 
object whose type is a subtype of one of the types in the catch clauses, then its 
catchBlock is executed. As soon as the catch block is entered, that exception 1s 
handled. 

If the tryBlock exits for any reason at all (because all of its statements executed 
completely; because one of its statements was a break, continue, or return state- 
ment; or because an exception was thrown), then the finallyBlock is executed. 

If the finallyBlock was entered because an exception was thrown and it itself 
throws another exception, then that exception masks the prior exception. 


A class can be placed in a package by putting the package declaration 


package packageName; 


as the first non-import declaration of the source file. 
A package name has the form 


identifier, .1dentifier). 
For example, 


java.util 
com.horstmann.bigjava 


A fully qualified name of a class is 
packageName .ClassName 


Classes can always be referenced by their fully qualified class names. However, this 
can be inconvenient. For that reason, you can reference imported classes by just 
their ClassName. All classes in the package java. 1ang and in the package of the cur- 
rent source file are alway imported. To import additional classes, use an import 
directive 


import packageName.ClassName; 
or 
import packageName.*; 


The second version imports all classes in the package. 
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A generic type is declared with one or more type parameters, placed after the type 
name: 


modifiers class|interface TypeName<typeParameter,, typeParameter), . . .> 


Similarly, a generic method is declared with one or more type parameters, placed 
before the method’s return type: 


modifiers <typeParameter,, typeParametery, . . .> returnType methodName 
Each type parameter has the form 

typeParameterName [extends bound, & bound, &. . .| 
For example, 


public class BinarySearchTree<T extends Comparable> 
public interface Comparator<T> 
public <T extends Comparable & Cloneable> T cloneMin(T[] values) 


Type parameters can be used in the definition of the generic type or method as if 
they were regular types. They can be replaced with any types that match the 
bounds. For example, the BinarySearchTree<String> type substitutes the String 
type for the type parameter T. 

Type parameters can also be replaced with wildcard types. A wildcard type has 
the form 


? [super|extends Type] 


It denotes a specific type that is unknown at the time that is defined. For example, 
Comparable<? super Rectangle> is a type Comparable<S> fora specific type S, which 
can be Rectangle or a supertype such as RectangularShape or Shape. 
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There are three kinds of comments: 


/* comment */ 
// one-line-comment 
/** documentationComment */ 


The one-line comment extends to the end of the line. The other comments can span 
multiple lines and extend to the */ delimiter. 
Documentation comments are further explained in Appendix K. 


FURTHER READING 


1. http://java.sun.com/docs/books/jls/ The Java Language Specification. 
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Java Operator 
summary 


The operators are listed in groups of decreasing precedence in the table below. The 
horizontal lines in the table indicate a change in operator precedence. For example, 
z= xX - y; meansz = (x - y); because = has lower precedence than -. 

The prefix unary operators and the assignment operators associate right-to-left. 
All other operators associate left-to-right. 


Operator Description Associativity 


Access class feature 


[] Array subscript Left to right 
@) Function call 

++ Increment 

“= Decrement 


| Boolean not 


S Bitwise not 


Right to left 
+ (unary) (Has no effect) 
- (unary) Negative 
(TypeName) Cast 


new Object allocation 
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Operator 


<< 
>> 


>>> 


instanceof 


Java Operator Summary 


Description 
Multiplication 
Division or integer division 
Integer remainder 
Addition, string concatenation 
Subtraction 
Shift left 
Arithmetic shift right 
Bitwise shift right 
Less than 
Less than or equal 
Greater than 
Greater than or equal 
Equal 
Not equal 


Tests whether an object’s type is a 


given type or a subtype thereof 
Bitwise and 

Bitwise exclusive or 

Bitwise or 

Boolean “short circuit” and 
Boolean “short circuit” or 


Assignment 


Assignment with binary operator (op is 
oneé of +, -; *,/, & 1,4, <<, >>; >>>) 


Associativity 


Left to right 


Left to right 


Left to right 


Left to right 


Left to right 
Left to right 
Left to right 
Left to right 
Left to right 


Right to left 


Keyword 
abstract 
assert 
boolean 
break 
byte 
case 
catch 
char 
class 
const 
continue 
default 
do 


double 
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Java Keyword 
summary 


Description 
An abstract class or method 
An assertion that a condition is fulfilled 
The Boolean type 
Breaks out of the current loop or labeled statement 
The 8-bit signed integer type 
A label in a switch statement 
The handler for an exception in a try block 
The 16-bit Unicode character type 
Defines a class 
Not used 
Skip the remainder of a loop body 
The default label in a switch statement 
A loop whose body is executed at least once 


The 64-bit double-precision floating-point type 


- 
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Keyword Description 
else The alternative clause in an if statement 
enum An enumerated type 
extends Indicates that a class is a subclass of another class 
final A value that cannot be changed after it has been initialized, a method that can’t be 
overridden, or a class that can’t be extended 
finally A clause of a try block that is always executed 
Float The 32-bit single-precision floating-point type 
for A loop with initialization, condition, and update expressions 
goto Not used 
if A conditional branch statement 


implements 
import 
instanceof 
int 
interface 
long 
native 

new 
package 
private 


protected 


public 
return 
short 

static 


StEILEEEp 


Indicates that a class realizes an interface 

Allows the use of class names without the package name 

Tests whether an object’s type is a given type or a subtype thereof 
The 32-bit integer type 

An abstract type with only abstract methods and constants 

The 64-bit integer type 

A method implemented in non-Java code 

Allocates an object 

A collection of related classes 

A feature that is accessible only by methods of the same class 


A feature that is accessible only by methods of the same class, a subclass, or 
another class in the same package 


A feature that is accessible by all methods 

Returns from a method 

The 16-bit integer type 

A feature that is defined for a class, not for individual instances 


Use strict rules for floating-point computations 
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Keyword 
super 
Switch 
synchronized 


this 


throw 
throws 
transient 
try 

void 
volatile 


while 


Description 
Invoke the superclass constructor or a superclass method 
A selection statement 
A block of code that is accessible to only one thread at a time 


The implicit parameter of a method; or invocation of another constructor of the 
same class 


Throws an exception 

The exceptions that a method may throw 

Fields that should not be serialized 

A block of code with exception handlers or a finally handler 
Tags a method that doesn’t return a value 


A field that may be accessed by multiple threads without synchronization 


A loop statement 
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Metric 
Conversion Factors 


Table 1 Metric Measurements Table 2 Metric Unit Factors 
Measure Name Type Unit Name Factor 
m meter Distance UW micro 1022 
iG liter Volume (= 1000 cm?) m milli 102 
g gram Weight c centi 102 
Cc degree Celsius Temperature k kilo 10° 
Table 3 Conversions from Nonmetric Units to Metric Units 
To convert from To Perform this operation 
Fluid ounce (fl. oz.) mL Multiply by 29.586 
Gallon iE Multiply by 3.785 
Ounce (0z.) g Multiply by 28.3495 
Pound (Ib.) kg = Multiply by 0.4536 
Inch (in.) cm Multiply by 2.54 
Foot (ft.) cm Multiply by 30.5 
Mile km = Multiply by 1.609 


Degrees Fahrenheit ((F) °C Subtract 32, then multiply by 5 and divide by 9 


Appendix 


HTML 
summary 


A web page is written in a language called HTML (Hypertext Markup Language). 
Like Java code, HTML code is made up of text that follows certain strict rules. 
When a browser reads a web page, the browser interprets the code and renders the 
page, displaying characters, fonts, paragraphs, tables, and images. 

HTML files are made up of text and tags that tell the browser how to render the 
text. Nowadays, there are dozens of HTML tags—see Table 1 for a summary of the 
most important tags. Fortunately, you need only a few to get started. Most HIML 
tags come in pairs consisting of an opening tag and a closing tag, and each pair 
applies to the text between the two tags. Here is a typical example of a tag pair: 


Java is an <i>object-oriented</i> programming language. 
The tag pair <i> </i> directs the browser to display the text inside the tags in italics: 
Java is an object-oriented programming language. 


The closing tag is just like the opening tag, but it is prefixed by a slash (/). For exam- 
ple, bold-faced text is delimited by <b> </b>, and a paragraph is delimited by the tag 


pair <p> </p>. 
<p><b>Java</b> is an <i>object-oriented</i> programming language. </p> 


The result is the paragraph 


Java is an object-oriented programming language. 
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Another common construct is a bulleted list. For example: 


Java is 


¢ object-oriented 
° sate 


e platform-independent 


Here is the HTML code to display it: 


<p>Java 1S</p> 
<ul><li>object-oriented</1i> 
<li>safe</li> 
<li>platform-independent</1li></ul> 


Each item in the list is delimited by <li> </li> (for “list item”), and the whole list is 
surrounded by <ul> </ul> (for “unnumbered list”). 

As in Java code, you can freely use white space (spaces and line breaks) in HTML 
code to make it easier to read. For example, you can lay out the code for a list as 
follows: 


<p>Java 1s</p> 

<ul> 

<li>object-oriented</li> 
<li>safe</li> 
<li>platform-independent</1i> 
</ul> 


The browser ignores the white space. 

If you omit a tag (such as a </li>), most browsers will try to guess the missing 
tags—sometimes with differing results. It is always best to include all tags. 

You can include images in your web pages with the img tag. In its simplest form, 
an image tag has the form 


<img src="hamster.jpeg"/> 


This code tells the browser to load and display the image that is stored in the file 
hamster. jpeg. This is a slightly different type of tag. Rather than text inside a tag 
pair <img> </img>, the img tag uses an attribute to specify a file name. Attributes 
have names and values. For example, the src attribute has the value "hamster. jpeg". 
Table 2 contains commonly used attributes. 

It is considered polite to use several additional attributes with the img tag, namely 
the image size and an alternate description: 

<img src="hamster.jpeg" width="640" height="480" 

alt="A photo of Harry, the Horrible Hamster"/> 
These additional attributes help the browser lay out the page and display a tempo- 
rary description while gathering the data for the image (or if the browser cannot 
display images, such as a voice browser for blind users). Users with slow network 
connections really appreciate this extra effort. 

Because there 1s no closing </img> tag, we put a slash / before the closing >. This 
is not a requirement of HTML, but it is a requirement of the emerging XHTML 


standard, the XML-based successor to HTML. See [1] for more information on 
XHTML. 


table 


br 


1 orem 
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Table 1 Selected HTML Tags 


Meaning Children 
HTML document head, body 
Head of an HTML document title 
Title of an HTML document 
Body of an HTML document 
Heading level 1... 6 
Paragraph 
Unnumbered list Vi 
Ordered list if 
Definition list dt, dd 
List item 
Term to be defined 
Definition data 
Table te 
Table row th, td 
Table header cell 
Table cell data 
Anchor 
Image 
Applet 
Preformatted text 
Horizontal rule 
Line break 


Italic 
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Commonly Used Attributes 


href, name 
src, width, height 


code, width, height 


borstrong Bold 


tt or code Typewriter or code font 

sorstrike Strike through 

u Underline 

super Superscript 

sub Subscript 

form Form action, method 

input Input field type, name, value, size, checked 

select Combo box style selector option name 

option Option for selection 
textarea Multiline text area name, rows, cols 
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Table 2 Selected HTML Attributes 


Attribute Description Commonly Contained in Element 
name Name of form element or anchor input, select, textarea, a 
href Hyperlink reference a 
Src Source (as of an image) img 
code Applet code applet 
width, height | Width, height of image or applet img, applet 
rows, cols Rows, columns of text area textarea 
type Type of input field, such as text, password, input 

checkbox, radio, submit, hidden 
value Value of input field, or label of submit button input 
Size Size of text field input 
checked Check radio button or checkbox Tnput 
action URL of form action form 
method GET or POST form 


The most important tag in web pages is the <a> </a> tag pair, which makes the 
enclosed text into a link to another file. The links between web pages are what 
makes the Web into, well, a web. The browser displays a link in a special way (for 
example, underlined text in blue color). Here is the code for a typical link: 


<a href="http://java.sun.com">Java</a> is an object-oriented 

programming language. 

When the viewer of the web page clicks on the word Java, the browser loads the 
web page located at java.sun.com. (The value of the href attribute is a Universal 
Resource Locator (URL), which tells the browser where to go. The prefix http:, for 
FAlypertext Transfer Protocol, tells the browser to fetch the file as a web page. Other 
protocols allow different actions, such as ftp: to download a file, mailto: to send 
e-mail to a user, and file: to view a local HTML file.) 

Finally, the applet tag includes an applet in a web page. To display an applet, you 
need first to write and compile a Java file to generate the applet code—see Advanced 
Topic 2.2. Then you tell the browser how to find the code for the applet and how 
much screen space to reserve for the applet. Here is an example: 


<applet code="HamsterApplet.class" width="400" height="300">An 
animation of Harry, the Horrible Hamster</applet> 


The text between the <applet> and </applet> tags is only displayed in lieu of the 
actual applet by browsers that can’t run Java applets. 

You have noticed that tags are enclosed in angle brackets (less-than and greater- 
than signs). What if you want to show an angle bracket on a web page? HTML pro- 
vides the notations &1t; and &gt; to produce the < and > symbols, respectively. Other 
codes of this kind produce symbols such as accented letters. The & (ampersand) 
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Table 3. Selected HTML Entities 


Entity Description Appearance 
&lt; Less than < 
&gt; Greater than > 
&amp ; Ampersand & 
&quot ; Quotation mark : 
&nbsp; Nonbreaking space 
&copy ; Copyright symbol © 


symbol introduces these codes; to get that symbol itself, use &amp;. See Table 3 for 
a summary. 

You may already have created web pages with a web editor that works like a 
word processor, giving you a WYSIWYG (what you see is what you get) view of 
your web page. But the tags are still there, and you can see them when you load the 
HTML file into a text editor. If you are comfortable using a WYSIWYG web editor, 
and if your editor can insert applet tags, you don’t need to memorize HTML tags at 
all. But many programmers and professional web designers prefer to work directly 
with the tags at least some of the time, because it gives them more control over their 


pages. 


FURTHER READING 


1. www.w3c.org/TR/xhtml1 The official web site for the XHTML 1.0 specification. 


In this summary, we use a monospaced font for actual commands such as javac. An 
italic font denotes descriptions of tool command components such as options. Items 


enclosed in brackets [. . .] are optional. Items separated by vertical bars | are 
alternatives. Do not include the brackets or vertical bars when typing in the 
commands. 


javac [options] sourceFile,|@fileList, sourceFile,|@file List, 


A file list 1s a text file that contains one file name per line. For example, 


File Greeting.list 


1 Greeting.java 
2 GreetingTest.java 


Then you can compile all files with the command 
javac @Greeting. list 


The Java compiler options are summarized in Table 1. 
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Option 


-classpath locations or 
-cp locations 


-sourcepath locations 


-d directory 
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Table 1 Common Compiler Options 


Description 


The compiler is to look for classes on this path, overriding the CLASSPATH 
environment variable. If neither is specified, the current directory is used. 


Each location is a directory, JAR file, or ZIP file. Locations are separated by 
a platform-dependent separator (: on Unix, ; on Windows). 


The compiler is to look for source files on this path. If not specified, source _ 
files are searched in the class path. 


The compiler places files into the specified directory. 


“g Generate debugging information. | 
-verbose Include information about all classes that are being compiled (useful for | 
troubleshooting). 
-deprecation Give detailed information about the usage of deprecated messages. 
-Xlint:errorlype Carry out additional error checking. If you get warnings about unchecked 
conversions, compile with the -Xlint: unchecked option. 


The following command loads the given class and starts its main method, passing it 
an array containing the provided command line arguments. 


java [options] ClassName [argument, argument, . . . | 


The following command loads the main class of the given JAR file and starts its main 
method, passing it an array containing the provided command line arguments. 


java [options] -jar jarFileName [argument argument, . . . | 


The Java virtual machine options are summarized in Table 2. 


Table 2 Common Virtual Machine Launcher Options 


Option 


-classpath locations or 
-cp locations 


-verbose 


-Dproperty=value 


Description 


Look for classes on this path, overriding the CLASSPATH environment 
variable. If neither is specified, the current directory is used. 


Each location is a directory, JAR file, or ZIP file. Locations are separated by 
a platform-dependent separator (: on Unix, ; on Windows). 


Trace class loading 


Set a system property that you can retrieve with the System. getProperties 
method. 
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appletviewer u7l, url, . 


The urls are searched for applets, and each applet is displayed in a separate window. 


An applet should be specified as an HTML tag of the form 


<applet 
code=applet Class File 
width=pzxels 
height=pzxels 
[codebase=relative URL]> 
<param name=parameterName, value=parameter Value ,> 
<param name=parameterName, value=parameter Value > 


</applet> 
The codebase parameter is an URL that is relative to the URL of the HTML file 
containing the applet or object tag. 


To combine one or more files into a JAR (Java Archive) file, use the command 


jar cvf jarFile file, file, . 
The resulting JAR file can be included in a class path. 


To build a program that can be launched with java -jar, you must create a 
manifest file, such as 


File myprog.mf 


1 Main-Class: com/horstmann/MyProg 


The manifest must specify the path name of the class file that launches the applica- 
tion, but with the .class extension removed. Then build the JAR file as 


jar cvfm jarFile manifestFile file, file, . 


You can also use JAR as a replacement for a ZIP utility, simply to compress and 
bundle a set of files for any purpose. Then you may want to suppress the generation 
of the JAR manifest, with the command 


jar cvfM jarFile file, file, . 

To extract the contents of a JAR file into the current directory, use 
jar xvf jarFile 

To see the files contained in a JAR file without extracting the files, use 
jar tvf jarFile 
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javadoc 
summary: 


setting Documentation 


A documentation comment is delimited by /** and */. You can comment 


© Classes 
@ Methods 
® Fields 


Each comment is placed immediately above the feature it documents. 

Each /** . . . */ documentation comment contains introductory text followed 
by tagged documentation. A tag starts with an @ character, such as @author or 
@param. Tags are summarized in Table 1. The first sentence of the introductory text 
should be a summary statement. The javadoc utility automatically generates sum- 
mary pages that extract these sentences. 

You can use HTML tags such as em for emphasis, code for a monospaced font, img 
for images, ul for bulleted lists, and so on. 
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Table 1 Common javadoc Tags 


Tag 


@param parameter explanation 


@return explanation 


@throws exceptionType explanation 


@deprecated 


@see packageName.ClassName 

@see packageName.ClassName 
#methodName(Type,, Type, 

@see packageName .ClassName#fieldName 


@author 


@version 


.) 


Description 


A parameter of a method. Use a separate tag for each 
parameter. 


The return value of a method. 


An exception that a method may throw. Use a separate 
tag for each exception. 


A feature that remains for compatibility but that 
should not be used for new code. 


A reference to a related documentation entry. 


The author of a class or interface. Use a separate tag for 
each author. 


The version of a class or interface. 


Here is a typical example. The summary sentence (in color) will be included with 


the method summary. 


slo ale 
aoa 


Withdraws money from the bank account. Increments the 


transaction count. 


@param amount the amount to withdraw 
@return the balance after the withdrawal 
@throws I1legalArgumentException if the balance is not sufficient 


public double withdraw(double amount) 


{ 


1f (balance - amount < minimumBalance) 
throw new IllegalArgumentException(); 
balance = balance - amount; 


transactions++; 
return balance; 
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Generating Documentation from 


To extract the comments, run the javadoc program: 


javadoc [options] sourceFile,| packageName,| Gfile List, 
sourceFile,| packageName,|@fileList, . 
See the documentation of the javac command in Appendix J for an explanation of 
file lists. Commonly used options are summarized in Table 2. 
To document all files in the current directory, use (all on one line) 


javadoc -link http://java.sun.com/j2se/1.5.0/docs/ap1 
-d docdir *.java 


| Table 2. Common javadoc Command Line Options 


Option Description 


-link URL Link to another set of Javadoc files. You should include a link to the standard 
library documentation, either locally or at the Sun web site, http: // 
java.sun.com/j2se/1.5.0/docs/api. 


-d directory Store the output in directory. This is a useful option, because it keeps your 
current directory from being cluttered up with javadoc files. 


-classpath locations Look for classes on the specified paths, overriding the CLASSPATH 
environment variable. If neither is specified, the current directory is used. 
Each location is a directory, JAR file, or ZIP file. Locations are separated by a 
platform-dependent separator (: on Unix, ; on Windows). 


| -sourcepath locations Look for source files on the specified paths. If not specified, source files are 
| searched in the class path. 


-author, -version Include author, version information in the documentation. This information is 


omitted by default. 


Appendix 


Sy stems 


Decimal notation represents numbers as powers of 10, for example 


1729 social = 1X10? +7107 +2x10'+9x10° 


There is no particular reason for the choice of 10, except that several historical num- 
ber systems were derived from people’s counting with their fingers. Other number 
systems, using a base of 12, 20, or 60, have been used by various cultures through- 
out human history. However, computers use a number system with base 2 because 
it is far easier to build electronic components that work with two values, which can 
be represented by a current being either off or on, than it would be to represent 10 
different values of electrical signals. A number written in base 2 is also called a 
binary number. 

For example, 


1101p inary = 1X 2? +127 +0x2' 41x29 =84441=13 
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For digits after the “decimal” point, use negative powers of 2. 


110t piracy = 1X 2241x275 4+0x27% 41x 2° 


(ere 
={4- 42 
2 8 


= 1+0.5+0.125 = 1.625 
In general, to convert a binary number into its decimal equivalent, simply evaluate 


the powers of 2 corresponding to digits with value 1, and add them up. Table 1 
shows the first powers of 2. 


Table 1 Powers of Two 


Power Decimal Value 

Dy 1 

be 2 

26 4 

9° 8 
De 16 
2 32 
De 64 
20 128 
pe 256 
2? 512 
2° 1,024 
Des 2,048 
22 4,096 
se 8,192 
Du 16,384 
22 32,768 
210 65,536 
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To convert a decimal integer into its binary equivalent, keep dividing the integer 
by 2, keeping track of the remainders. Stop when the number is 0. Then write the 
remainders as a binary number, starting with the /ast one. For example, 


100 + 2 = 50 remainder 0 
50 +2 = 25 remainder 0 
25 +2 = 12 remainder 1 
12 +2 =6 remainder 0 

6 +2 =3 remainder 0 
3 +2 =1 remainder 1 


1+2=0 remainder 1 


Theretore, 100 gecimal = 1100100 pinary- a 

Conversely, to convert a fractional number less than 1 to its binary format, keep 
multiplying by 2. If the result is greater than 1, subtract 1. Stop when the number is 
0. Then use the digits before the decimal points as the binary digits of the fractional 
part, starting with the first one. For example, 


0.35-2 = 0.7 
0.7-2=1.4 
0.4:2=0.8 
0.8-2 = 1.6 
0.6-2=1.2 
0.2:2=0.4 


Here the pattern repeats. That is, the binary representation of 0.35 is 0.01 0110 0110 
O110... 

To convert any floating-point number into binary, convert the whole part and 
the fractional part separately. 


To represent negative integers, there are two common representations, called 
“signed magnitude” and “two’s complement”. Signed magnitude notation is simple: 
use the leftmost bit for the sign (0 = positive, 1 =negative). For example, when using 
8-bit numbers, 


—13 = 10001101 


signed magnitude 
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However, building circuitry for adding numbers gets a bit more complicated when 
one has to take a sign bit into account. The two’s complement representation solves 
this problem. To form the two’s complement of a number, 


e Flip all bits. 
e Then add 1. 


For example, to compute —13 as an 8-bit value, first flip all bits of 00001101 to get 
11110010. Then add 1: 


—13 = 11110011 


two’s complement 


Now no special circuitry is required for adding two numbers. Simply follow the 
normal rule for addition, with a carry to the next position if the sum of the digits 
and the prior carry is 2 or 3. For example, 


44211 111 
+13 0000 1101 
213 1111 0011 


1 0000 0000 


But only the last 8 bits count, so +13 and —13 add up to 0, as they should. 

In particular, -1 has two’s complement representation 1111... 1111, with all bits 
set. 

The leftmost bit of a two’s complement number is 0 if the number is positive or 
zero, | if it is negative. 

Two’s complement notation with a given number of bits can represent one more 
negative number than positive numbers. For example, the 8-bit two’s complement 
numbers range from —128 to +127. 

This phenomenon is an occasional cause for a programming error. For example, 
consider the following code: 


byte: b =... «wi 
if (b < 0) b= (byte) -b; 


This code does not guarantee that b is nonnegative afterwards. If b happens to be 
—128, then computing its negative again yields —128. (Try it out—take 10000000, flip 
all bits, and add 1.) 


The Institute for Electrical and Electronics Engineering (IEEE) defines standards 
for floating-point representations in the IEEE-754 standard. Figure 1 shows how 
single-precision (float) and double-precision (double) values are decomposed into 
e A sign bit 


e An exponent 


e A mantissa 
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1 bit 8 bit 23 bit 


Single Precision 


1 bit 11 bit 52 bit 


sigi 
Double Precision 


Figure 1  JEEE Floating-Point Representation 


Floating-point numbers use scientific notation, in which a number is represented as 
e 
by .b,b,b, eee x Z 


In this representation, e is the exponent, and the digits dy.b,b,b,... form the man- 
tissa. The normalized representation is the one where by # 0. For example, 


100 gecimal = 1100100 p inary = 1100100 binary X 2° 


Because in the binary number system the first bit of a normalized representation 
must be 1, it is not actually stored in the mantissa. Therefore, you always need to 
add it on to represent the actual value. For example, the mantissa 1.100100 is stored 
as 100100. 

The exponent part of the IEEE representation uses neither signed magnitude nor 
two’s complement representation. Instead, a bias is added to the actual exponent. 
The bias is 127 for single-precision numbers, 1023 for double-precision numbers. 
For example, the exponent e=6 would be stored as 133 in a single-precision 
number. 


Thus, 


100 decimal = 9 10000 UML single-precision IEEE 


In addition, there are several special values. Among them are: 


e Zero: biased exponent = 0, mantissa = 0. 
e Infinity: biased exponent = 11...1, mantissa = +0. 


° NaN (not a number): biased exponent = 11...1, mantissa # +0. 
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Because binary numbers can be hard to read for humans, programmers often use 
the hexadecimal number system, with base 16. The digits are denoted as 0, 1,...,9 
A, B, C, D, E, F (see Table 2). 

Four binary digits correspond to one hexadecimal digit. That makes it easy to 
convert between binary and hexadecimal values. For example, 


>) 


11/1011 | 0001 binary = 3Bl hexadecimal 


In Java, hexadecimal numbers are used for Unicode character values, such as \u03B1 
(the Greek lowercase letter alpha). Hexadecimal integers are denoted with a 0x pre- 
fix, such as 0x3B1. 


Table 2 Hexadecimal Digits 


Hexadecimal Decimal Binary 

0 0 0000 | 

1 1 0001 

2 2 0010 

3 3 OO11 
| 4 4 0100 
| 5 5) 0101 | 
| 6 6 0110 
| 7 7 0111 
8 8 1000 
9 9 1001 
| A 10 1010 

B Ll 1011 

G 12 1100 

D 13 L101 

EB 14 1110 

E 15 itt 
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Bit and Shift 
Operations 


There are four bit operations in Java: the unary negation (~) and the binary and (&), 
or (|), and exclusive or (A), often called xor. 

Tables 1 and 2 show the truth tables for the bit operations in Java. When a bit 
operation is applied to integer values, the operation is carried out on corresponding 


bits. 


Table 1 The Unary Negation Operation 


a ~a 
0) 1 
1 ) 


Table 2 The Binary And, Or, and Xor Operations 


a b a&b a |b aAb 
0 0 0 0 0) 
0 i 0 1 1 
1 0 ) 1 1 
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For example, suppose we want to compute 46 & 13. First convert both values to 
binary. 46Jecimal = 101110 pinary (actually 00000000000000000000000000101110 as a 
32-bit integer), and 13g.cimal = 1101, inary: Now combine corresponding bits: 


ne ihe 0101110 
Beh ioc oe 0001101 
Oe eon 2 0001100 


The answer is 1100pinary = 12 decimal: | | | 

You sometimes see the | operator being used to combine two bit patterns. For 
example, Font.BOLD is the value 1, Font. ITALIC is 2. The binary or combination 
Font.BOLD | Font. ITALIC has both the bold and the italic bit set: 


Orta: 0000001 
=. yee 0000010 
ee 0000011 


Don’t confuse the & and | bit operators with the && and || operators. The latter 
work only on boolean values, not on bits of numbers. 


ALI EO 


Left shift (<<) 


OX 


Arithmetic right shift (>>) 


SSS 


Bitwise right shift (>>>) 


Figure 1 The Shift Operations 
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Besides the operations that work on individual bits, there are three shift opera- 
tions that take the bit pattern of a number and shift it to the left or right by a given 
number of positions. There are three shift operations: shift left (<<), arithmetic shit 
right (>>), and bitwise shift right (>>>). 

The left shift moves all bits to the left, filling in zeroes in the least significant bits. 
Shifting to the left by 7 bits yields the same result as multiplication by 2”. The arith- 
metic right shift moves all bits to the right, propagating the sign bit. Therefore, the 
result is the same as integer division by 2”, both for positive and negative values. 
Finally, the bitwise right shift moves all bits to the right, filling in zeroes in the most 
significant bits. (See Figure 1.) 

Note that the right-hand-side value of the shift operators is reduced modulo 32 
(for int values) or 64 (for long values) to determine the actual number of bits to 
shift. For example, 1 << 35 is the same as1 << 3. Actually shifting 1 by 35 bits to the 
left would make no sense—the result would be 0. 

The expression 


1 << n 


yields a bit pattern in which the nth bit is set (where the 0 bit is the least significant 
bit). 

To set the nth bit of a number, carry out the operation 

x =x | 1 << n 
To check whether the nth bit is set, execute the test 

17 (Ce @ 1 ee a) fe O)-s: 4 « 


Note that the parentheses around the & are required—the & operator has a lower 
precedence than the relational operators. 
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UML 
summary 


In this book, we use a very restricted subset of the UML notation. This appendix 
lists the components of the subset. For a complete discussion of the UML notation, 
see [1]. 

Figure 1 shows the notation for classes and interfaces. You can optionally supply 
attributes and methods; see Figure 2. Table 1 shows the arrows that indicate rela- 
tionships between them. 


«interface» — 
_ InterfaceName 
UML Symbols for Classes and Interfaces 


~BankAccount a riributes 
balance = 
ee Methods 
deposit 2 
He col _ withdraw() 
Attributes and Methods inaClass Diagram = = 
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| Relat tion ashi ip 


1. Grady Booch, James Rumbaugh, and Ivar Jacobson, The Unified Modeling Language 
User Guide, Addison-Wesley, 2005, 1999. 


Glossary 


Abstract array An ordered sequence of items that can be efficiently accessed at random 
through an integer index. 


Abstract class A class that cannot be instantiated. 


Abstract list An ordered sequence of items that can be traversed sequentially and that allows 
for efficient insertion and removal of elements at any position. 


Abstract method A method with a name, parameter types, and return type but without an 
implementation. 


Abstraction The process of finding the essential feature set for a building block of a program 
such as a class. 


Access specifier A keyword that indicates the accessibility of a feature, such as private or 
public. 


Accessor method A method that accesses an object but does not change it. 
Actual parameter The expression supplied for a formal parameter of a method by the caller. 


ADT (Abstract Data Type) A specification of the fundamental operations that characterize a 
data type, without supplying an implementation. 


Aggregation ‘The has-a relationship between classes. 


Algorithm An unambiguous, executable, and terminating specification of a way to solve a 
problem. 


Anonymous class A class that does not have a name. 

Anonymous object An object that is not stored in a named variable. 

API (Application Programming Interface) A code library for building programs. 

Applet A graphical Java program that executes inside a web browser or applet viewer. 


Argument An actual parameter in a method call, or one of the values combined by an 
operator. 


Array A collection of values of the same type stored in contiguous memory locations, each 
of which can be accessed by an integer index. 
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Array list A Java class that implements a dynamically growable array of objects. 
Assertion A claim that a certain condition holds in a particular program location. 
Assignment Placing a new value into a variable. 


Association A relationship between classes in which one can navigate from objects of one 
class to objects of the other class, usually by following object references. 


Asymmetric bounds Bounds that include the starting index but not the ending index. 
Attribute A named property that an object is responsible for maintaining. 
Auto-boxing Automatically converting a primitive type value into a wrapper type object. 


Balanced tree A tree in which each subtree has the property that the number of descendants 
to the left is approximately the same as the number of descendants to the right. 


Big-Oh notation ‘The notation g(z) = O(f(2)), which denotes that the function g grows at a 
rate that is bounded by the growth rate of the function f with respect to n. For example, 
1027 + 100n — 1000 = O(n”). 


Binary file A file in which values are stored in their binary representation and cannot be read 
as text. 


Binary operator An operator that takes two arguments, for example + in x +4. 


Binary search A fast algorithm to find a value in a sorted array. It narrows the search down 
to half of the array in every step. 


Binary search tree A binary tree in which each subtree has the property that all left descen- 
dants are smaller than the value stored in the root, and all right descendants are larger. 


Binary tree A tree in which each node has at most two child nodes. 


Bit Binary digit; the smallest unit of information, having two possible values: 0 and 1. A 
data element consisting of 7 bits has 2” possible values. 


Black-box testing ‘Testing a method without knowing its implementation. 

Block A group of statements bracketed by {}. 

Blocked thread A thread that cannot proceed because it is waiting for some external event. 
Boolean operator See Logical operator 

Boolean type A type with two possible values: true and false. 


Border layout A layout management scheme in which components are placed into the center 
or one of the four borders of their container. 


Boundary test case A test case involving values that are at the outer boundary of the set of 
legal values. For example, if a function is expected to work for all nonnegative integers, then 
0 is a boundary test case. 


Bounds error ‘Trying to access an array element that is outside the legal range. 


Breakpoint A point in a program, specified in a debugger, at which the debugger stops exe- 
cuting the program and lets the user inspect the program state. 


break statement A statement that terminates a loop or switch statement. 


Bucket Ina hash table, a set of values with the same hash code. 
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Buffer A temporary storage location for holding values that have been produced (for exam- 
ple, characters typed by the user) and are waiting to be consumed (for example, read a line at 
a time). 


Buffered input Input that is gathered in batches, for example, a line at a time. 
Bug <A programming error. 


Byte A number made up of eight bits. Essentially all currently manufactured computers use 
a byte as the smallest unit of storage in memory. 


Bytecode Instructions for the Java virtual machine. 


Call by reference A method call mechanism in which the method receives the location in 
memory of a variable supplied as an actual parameter. Call by reference enables a method to 
change the contents of the original variable so that the change remains in effect after the 
method returns. 


Call by value A method call mechanism in which the method receives a copy of the contents 
of a variable supplied as an actual parameter. Java uses only call by value. If a parameter vari- 
able’s type is a class, its value is an object reference, so the method can alter that object but 
cannot make the parameter variable refer to a different object. 


Call stack The ordered set of all methods that currently have been called but not yet termi- 
nated, starting with the current method and ending with main. 


Case sensitive Distinguishing upper- and lowercase characters. 


Cast Explicitly converting a value from one type to a different type. For example, the cast 
from a floating-point number x to an integer is expressed in Java by the cast notation (int) x. 


catchclause A part of a try block that is executed when a matching exception is thrown by 
any statement in the try block. 


Character A single letter, digit, or symbol. 
Check box A user interface component that can be used for a binary selection. 


Checked exception An exception that the compiler checks. All checked exceptions must be 
declared or caught. 


Class A programmer-defined data type. 
Class method See Static method 
Class path The set of directories and archives that the virtual machine searches for class files. 


Client A computer program or system that issues requests to a server and processes the 
server responses. 


Cloning Making a copy of an object whose state can be modified independently of the orig- 
inal object. 


Cohesion A class is cohesive if its features support a single abstraction. 
Collaborator A class on which another class depends. 


Combo box A user interface component that combines a text field with a drop-down list of 
selections. 
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Command line The line the user types to start a program in DOS or UNIX or a command 
window in Windows. It consists of the program name followed by any necessary arguments. 


Comment An explanation to help the human reader understand a section of a program; 
ignored by the compiler. 


Compiler A program that translates code in a high-level language (such as Java) to machine 
instructions (such as bytecode for the Java virtual machine). 


Compile-time error An error that is detected when a program is compiled. 
Component See User interface component 


Compound statement A statement such as if or while that is made up of several parts such as 
a condition and a body. 


Concatenation Placing one string after another to form a new string. 

Concrete class A class that can be instantiated. 

Condition See Condition object 

Condition object An object that manages threads that currently cannot proceed. 


Console program A Java program that does not have a graphical window. A console program 
reads input from the keyboard and writes output to the terminal screen. 


Constant A value that cannot be changed by a program. In Java, constants are defined with 
the keyword final. 


Construction Setting a newly allocated object to an initial state. 
Constructor A method that initializes a newly instantiated object. 


Container A user interface component that can hold other components and present them 
together to the user. Also, a data structure, such as a list, that can hold a collection of objects 
and present them individually to a program. 


Content pane The part of a Swing frame that holds the user interface components of the 
frame. 


Coupling The degree to which classes are related to each other by dependency. 
CPU (Central Processing Unit) The part of a computer that executes the machine instructions. 


CRC card An index card representing a class that lists its responsibilities and collaborating 
classes. 


De Morgan’s Law A law about logical operations that describes how to negate expressions 
formed with and and or operations. 


Deadlock A state in which no thread can proceed because each thread is waiting for another 
to do some work first. 


Deadly embrace A set of blocked threads, each of which could only be unblocked by the 
action of other threads in the set. 


Debugger A program that lets a user run another program one or a few steps at a time, stop 
execution, and inspect the variables in order to analyze it for bugs. 


Default constructor A constructor that is invoked with no parameters. 
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Dependency The uses relationship between classes, in which one class needs services pro- 
vided by another class. 


Dictionary ordering See Lexicographic ordering 
Directory A structure on a disk that can hold files or other directories; also called a folder. 


Documentation comment A comment ina source file that can be automatically extracted into 
the program documentation by a program such as javadoc. 


Dot notation The notation object.method(parameters) or object.field used to invoke a 
method or access a field. 


Doubly linked list. A linked list in which each link has a reference to both its predecessor and 
successor links. 


DID (Document Type Definition) A sequence of rules that describes the legal child elements 
and attributes for each element type in an SGML or XML document. 


Early binding Choosing at compile time among several methods with the same name but dit- 
ferent parameter types. 


Editor A program for writing and modifying text files. 


Embedded system A processor, software, and supporting circuitry that is included ina device 
other than a computer. 


Encapsulation The hiding of implementation details. 


End of file The condition that is true when all characters of a file have been read. Note that 
there is no special “end of file character”. When composing a file on the keyboard, you may 
need to type a special character to tell the operating system to end the file, but that character 
is not part of the file. 


Enumerated type A type with a finite number of values, each of which has its own symbolic 
name. 


Escape character A character in text that is not taken literally but has a special meaning when 
combined with the character or characters that follow it. The \ character is an escape charac- 
ter in Java strings. 


Event class A class that contains information about an event, such as its source. 


Event adapter A class that implements an event listener interface by defining all methods to 
do nothing. 


Event handler A method that is executed when an event occurs. 
Event listener An object that is notified by an event source when an event occurs. 
Event source An object that can notify other classes of events. 


Exception A class that signals a condition that prevents the program from continuing nor- 
mally. When such a condition occurs, an object of the exception class is thrown. 


Exception handler A sequence of statements that is given control when an exception of a par- 
ticular type has been thrown and caught. 


Explicit parameter A parameter of a method other than the object on which the method is 
invoked. 


1152 


Glossary 


Expression A syntactical construct that is made up of constants, variables, method calls, and 
operators combining them. 


Extension The last part of a file name, which specifies the file type. For example, the exten- 
sion .java denotes a Java file. 


Extreme Programming A development methodology that strives for simplicity, by removing 
formal structure and focusing on best practices. 


Fibonacci numbers ‘The sequence of numbers 1, 1, 2, 3, 5, 8, 13,..., in which every term is 
the sum of its two predecessors. 


File A sequence of bytes that is stored on disk. 


File pointer The position within a random-access file of the next byte to be read or written. 
It can be moved so as to access any byte in the file. 


finally clause A part of a try block that is executed no matter how the try block is exited. 
Flag See Boolean type 

Floating-point number =A number that can have a fractional part. 

Flow layout A layout management scheme in which components are laid out left to right. 
Flushing a stream Sending all characters that are still held in a buffer to its destination. 
Folder See Directory 

Font A set of character shapes in a particular style and size. 

Foreign key A reference to a primary key ina linked table. 


Formal parameter A variable in a method definition; it is initialized with an actual parameter 
value when the method is called. 


Frame A window with a border and a title bar. 


Garbage collection Automatic reclamation of memory occupied by objects that are no longer 
referenced. 


Generic class A class with one or more type parameters. 
Generic method A method with one or more type parameters. 


Generic programming Providing program components that can be reused in a wide variety of 
situations. 


goto statement A statement that transfers control to some other statement, which is tagged 
with a label. Java does not have a goto statement. 


Grammar A set of rules that specifies which sequences of tokens are legal for a particular 
document set. 


Graphics context A class through which a programmer can cause shapes to appear on a win- 
dow or off-screen bitmap. 


grep The “global regular expression print” search program, useful for finding all strings 
matching a pattern ina set of files. 


Grid layout A layout management scheme in which components are placed into a two- 
dimensional grid. 
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GUI (Graphical User Interface) A user interface in which the user supplies inputs through 
graphical components such as buttons, menus, and text fields. 


Hash code A value that is computed by a hash function. 
Hash collision Two different objects for which a hash function computes identical values. 


Hash function A function that computes an integer value from an object in such a way that 
different objects are likely to yield different values. 


Hash table A data structure in which elements are mapped to array positions according to 
their hash function values. 


Hashing Applying a hash function to a set of objects. 


Heap A balanced binary tree that is used for implementing sorting algorithms and priority 
queues. 


Heapsort algorithm A sorting algorithm that inserts the values to be sorted into a heap. 
HTML (Hypertext Markup Language) The language in which web pages are described. 


HTTP (Hypertext Transfer Protocol) The protocol that defines communication between web 
browsers and web servers. 


IDE (Integrated Development Environment) A programming environment that includes an 
editor, compiler, and debugger. 


immutable class A class without a mutator method. 
implementing an interface See Realizing an interface 


implicit parameter The object on which a method is invoked. For example, in the call x. f(y), 
the object x is the implicit parameter of the method f. 


Importing a class or package Indicating the intention of referring to a class, or all classes in a 
package, by the simple name rather than the qualified name. 


Inheritance The zs-a relationship between a more general superclass and a more specialized 
subclass. 


initialization Setting a variable to a well-defined value when it is created. 
Inner class A class that is defined inside another class. 


instance method A method with an implicit parameter; that is, a method that is invoked on 
an instance of a class. 


Instance of aclass An object whose type is that class. 


Instance field A variable defined in a class for which every object of the class has its own 
value. 


instantiation of aclass Construction of an object of that class. 
integer A number that cannot have a fractional part. 


integer division Taking the quotient of two integers and discarding the remainder. In Java 
the / symbol denotes integer division if both arguments are integers. For example, 11/4 1s 2, 
Not 2275. 


Interface A type with no instance variables, only abstract methods and constants. 
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Internet A worldwide collection of networks, routing equipment, and computers using a 
common set of protocols that define how participants interact with each other. 


Interpreter A program that reads a set of codes and carries out the commands specified by 
them. 


Iterator An object that can inspect all elements in a container such as a linked list. 


JavaBean A class with a default constructor that exposes properties through its get and set 
methods. 


javadoc The documentation generator in the Java SDK. It extracts documentation com- 
ments from Java source files and produces a set of linked HTML files. 


JavaServer Faces (JSF) A framework for developing web applications that aids in the separa- 
tion of user interface and program logic. 


JDBC (Java Database Connectivity) The technology that enables a Java program to interact 
with relational databases. 


JDK The Java software development kit that contains the Java compiler and related develop- 
ment tools. 


Join A database query that involves multiple tables. 
JSF container A program that executes JSF applications. 
JVM The Java Virtual Machine 


Late binding Choosing at run time among several methods with the same name invoked on 
objects belonging to subclasses of the same superclass. 


Layout manager A class that arranges user interface components inside a container. 


Lazy evaluation Deterring the computation of a value until it is needed, thereby avoiding the 
computation if the value is never needed. 


Legacy code Software that has existed for a long time and that continues to operate. 


Lexicographic ordering Ordering strings in the same order as in a dictionary, by skipping all 
matching characters and comparing the first nonmatching characters of both strings. For 
example, “orbit” comes before “orchid” in lexicographic ordering. Note that in Java, unlike 
a dictionary, the ordering is case-sensitive: Z comes before a. 


Library A set of precompiled classes that can be included in programs. 


Linear search Searching a container (such as an array or list) for an object by inspecting each 
element in turn. 


Linked list A data structure that can hold an arbitrary number of objects, each of which is 
stored in a link object, which contains a pointer to the next link. 


Local variable A variable whose scope is a block. 


Lock A data structure to regulate the scheduling of multiple threads. Once a thread has 
acquired a lock, other threads that also wish to acquire it must wait until the first thread 
relinquishes it. | 


Lock object An object that allows a single thread to execute a section of a program. 


Logging Sending messages that trace the progress of a program to a file or window. 
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Logical operator An operator that can be applied to Boolean values. Java has three logical 
operators: &&, ||, and !. 


Logic error An error ina syntactically correct program that causes it to act differently from 
its specification. 


Loop A sequence of instructions that is executed repeatedly. 
Loop and ahalf A loop whose termination decision is neither at the beginning nor at the end. 


Loop invariant A statement about the program state that is preserved when the statements in 
the loop are executed once. 


Machine code “Instructions that can be executed directly by the CPU. 

Magic number A number that appears in a program without explanation. 
mainmethod The method that is first called when a Java application executes. 
Managed bean A JavaBean that is managed by a JSF container. 

Map A data structure that keeps associations between key and value objects. 


Markup Information about data that is added as humanly readable instructions. An example 
is the tagging of HIML documents with elements such as <h1> or <b>. 


Member A method, field, or type defined inside a class. 
Memory location A value that specifies the location of data in computer memory. 


Merge sort A sorting algorithm that first sorts two halves of a data structure and then 
merges the sorted subarrays together. 


Meta data Data that describe properties of a data set. 


Method A sequence of statements that has a name, may have formal parameters, and may 
return a value. A method can be invoked any number of times, with different values for its 
parameters. 


Method binding In JSF, an expression describing a bean and a method that is to be applied to 
the bean at a later time. 


Method signature The name of a method and the types of its parameters. 

Mixed content In XML, a markup element that contains both text and other elements. 
Mutator method A method that changes the state of an object. 

Mutual recursion Cooperating methods that call each other. 


Name clash Accidentally using the same name to denote two program features in a way that 
cannot be resolved by the compiler. 


Navigation rule In JSF, a rule that describes when to move from one web page to another. 


Negative test case A test case that is expected to fail. For example, when testing a root- 
finding program, an attempt to compute the square root of —1 is a negative test case. 


Nested block A block that is contained inside another block. 


Nested loop A loop that is contained in another loop. 
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Network protocol A set of rules that must be followed by programs that communicate over a 
network. 


new operator An operator that allocates new objects. 

Newline The '\n' character, which indicates the end of a line. 
Null reference A reference that does not refer to any object. 
Object A value of a class type. 


Object-oriented design Designing a program by discovering objects, their properties, and 
their relationships. 


Object reference A value that denotes the location of an object in memory. In Java, a variable 
whose type is a class contains a reference to an object of that class. 


Off-by-one error A common programming error in which a value is one larger or smaller 


than it should be. 


Opening a file Preparing a file for reading or writing. 


Operating system The software that launches application programs and provides services 
(such as a file system) for those programs. 


Operator A symbol denoting a mathematical or logical operation, such as + or &&. 


Operator associativity ‘The rule that governs in which order operators of the same precedence 
are executed. For example, in Java the - operator is left-associative because a - b - c is 
interpreted as (a - b) - c, and = is right-associative because a = b = c is interpreted as 
a= (b =). 


Operator precedence The rule that governs which operator is evaluated first. For example, in 
Java the && operator has a higher precedence than the || operator. Hence a || b && c is 
interpreted asa || (b && c). 


Oracle A program that predicts how another program should behave. 
Overloading Giving more than one meaning to a method name. 
Overriding Redefining a method in a subclass. 


Package A collection of related classes. The import statement is used to access one or more 
classes in a package. 


Package access Accessibility by methods of classes in the same package. 


Panel A user interface component with no visual appearance. It can be used to group other 
components. 


Parallel arrays Arrays of the same length, in which corresponding elements are logically 
related. 


Parameter An item of information that is specified to a method when the method is called. 
For example, in the call System.out.printIn("Hello, World!"), the parameters are the 
implicit parameter System. out and the explicit parameter "Hello, World!". 


Parameter passing Specifying expressions to be actual parameter values for a method when it 
is called. 
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Parameter variable A variable of a method that is initialized with a parameter value when the 
method is called. 


Parse tree A tree structure that shows how a string conforms to rules of a grammar. 


Parser A program that reads a document, checks whether it is syntactically correct, and 
takes some action as it processes the document. 


Partially-filled array An array that is not filled to capacity, together with a companion vari- 
able that indicates the number of elements actually stored. 


Permutation A rearrangement of a set of values. 


Polymorphism Selecting a method among several methods that have the same name on the 
basis of the actual types of the implicit parameters. 


Positive test case A test case that a method is expected to handle correctly. 
Postcondition A condition that is true after a method has been called. 
Postfix operator A unary operator that is written after its argument. 


Precondition A condition that must be true when a method is called if the method is to work 
correctly. 


Predicate method A method that returns a Boolean value. 
Prefix operator A unary operator that is written before its argument. 
Prepared statement A SQL statement with a precomputed query strategy. 


Primary key A column (or combination of columns) whose value uniquely specifies a table 
record. 


Primitive type In Java, a number type or boolean. 


Priority queue An abstract data type that enables efficient insertion of elements and efficient 
removal of the smallest element. 


Private feature A feature that is accessible only by methods of the same class or an inner 
class. 


Project A collection of source files and their dependencies. 
Prompt A string that tells the user to provide input. 
Property A named value that is managed by a component. 


Protected feature A feature that is accessible by a class, its inner classes, its subclasses, and 
the other classes in the same package. 


Pseudorandom number A number that appears to be random but is generated by a mathe- 
matical formula. 


Public feature A feature that is accessible by all classes. 


Public interface The features (methods, fields, and nested types) of a class that are accessible 
to all clients. 


Qualified name A name that is made unambiguous because it starts with the package name. 


Queue A collection of items with “first in, first out” retrieval. 
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Quicksort A generally fast sorting algorithm that picks an element, called the pivot, parti- 
tions the sequence into the elements smaller than the pivot and those larger than the pivot, 
and then recursively sorts the subsequences. . 


Race condition A condition in which the effect of multiple threads on shared data depends 
on the order in which the threads are scheduled. 


Radio button A user interface component that can be used for selecting one of several 
options. 


RAM (Random-Access Memory) Electronic circuits in a computer that can store code and data 
of running programs. 


Random access The ability to access any value directly without having to read the values 
preceding it. 


Reader In the Java input/output library, a class from which to read characters. 
Realizing an interface Implementing a class that defines all methods specified in the interface. 


Recursion A method for computing a result by decomposing the inputs into simpler values 
and applying the same method to them. 


Recursive method A method that can call itself with simpler values. It must handle the sim- 
plest values without calling itself. 


Redirection Linking the input or output of a program to a file instead of the keyboard or 
display. 
Reference See Object reference 


Regression testing Keeping old test cases and testing every revision of a program against 
them. 


Regular expression A string that defines a set of matching strings according to their content. 
Each part of a regular expression can be a specific required character; one of a set of permit- 
ted characters such as [abc], which can be a range such as [a-z]; any character not in a set of 
forbidden characters, such as [*0-9]; a repetition of one or more matches, such as [0-9]+, or 
zero or more, such as [ACGT]*; one of a set of alternatives, such as and|et|und; or various 
other possibilities. For example, "[A-Za-z]*[0-9]+" matches "Cloud9" or "007" but not 
"Jack". 


Relational database A data repository that stores information in tables and retrieves data as 
the result of queries that are formulated in terms of table relationships. 


Relational operator An operator that compares two values, yielding a Boolean result. 


Reserved word A word that has a special meaning in a programming language and therefore 
cannot be used as a name by the programmer. 


Return value The value returned by a method through a return statement. 


Reverse Polish notation A style of writing expressions in which the operators are written fol- 
lowing the operands, suchas 2 3 4 * +for2 +3 * 4. 


Roundoff error An error introduced by the fact that the computer can store only a finite 
number of digits of a floating-point number. 


Runnable thread A thread that can proceed provided it is given a time slice to do work. 
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Run-time error See Logic error 


Run-time stack The data structure that stores the local variables of all called methods as a 
program runs. 


Scope The part of a program in which a variable is defined. 


Scripting language A programming language that favors rapid development over execution 
speed and code maintainability. 


Selection sort A sorting algorithm in which the smallest element is repeatedly found and 
removed until no elements remain. 


Sentinel A value in input that is not to be used as an actual input value but to signal the end 
of input. 


Sequential access Accessing values one after another without skipping over any of them. 
Sequential search See Linear search 


Serialization The process of saving an object, and all the objects that it references, to a 
stream. 


Server A computer program or system that receives requests from a client, obtains or com- 
putes the requested information, and sends it to the client. 


Session A sequence of page requests from the same browser to the same web server. 


Set An unordered collection that allows efficient addition, location, and removal of 
elements. 


Shadowing Hiding a variable by defining another one with the same name. 
Shallow copy Copying only the reference to an object. 


Shell A part of an operating system in which the user types command lines to execute pro- 
erams and manipulate files. 


Shell script A file that contains commands for running programs and manipulating files. 
Typing the name of the shell script file on the command line causes those commands to be 
executed. 


Shell window A window for interacting with an operating system through textual commands. 


Short circuit evaluation Evaluating only a part of an expression if the remainder cannot 
change the result. 


Side effect An effect of a method other than returning a value. 
Sign bit The bit of a binary number that indicates whether the number is positive or negative. 


Signature See Method signature 


Simple statement A statement consisting only of an expression. 
Single-stepping Executing a program in the debugger one statement at a time. 


Socket An object that encapsulates a TCP/IP connection. To communicate with the other 
endpoint of the connection, you use the input and output streams attached to the socket. 


Software life cycle All activities related to the creation and maintenance of the software from 
initial analysis until obsolescence. 
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Source code Instructions in a programming language that need to be translated before exe- 
cution on a computer. 


Source file A file containing instructions in a programming language such as Java. 
Spaghetti code ‘Tangled control flow that is difficult to understand. 


Spiral model An iterative process model of software development in which design and 
implementation are repeated. 


SQL (Structured Query Language) A command language for interacting with a database. 


Stack A data structure with “last in, first out” retrieval. Elements can be added and 
removed only at one position, called the top of the stack. 


Stack trace A printout of the call stack, listing all currently pending method calls. 


State The current value of an object, which is determined by the cumulative action of all 
methods that were invoked on it. 


State diagram A diagram that depicts state transitions and their causes. 


Statement A syntactical unit in a program. In Java a statement is either a simple statement, a 
compound statement, or a block. 


Static method §=A method with no implicit parameter. 


Static field A variable defined in a class that has only one value for the whole class, which 
can be accessed and changed by any method of that class. 


Stored procedures A database procedure that is executed in the database kernel. 


Stream An abstraction for a sequence of bytes from which data can be read or to which data 
can be written. 


String A sequence of characters. 
Stub A method with no or minimal functionality. 


Subclass A class that inherits variables and methods from a superclass but adds instance 
variables, adds methods, or redefines methods. 


Superclass A general class from which a more specialized class (a subclass) inherits. 
Swing A Java toolkit for implementing graphical user interfaces. 
Symmetric bounds Bounds that include the starting index and the ending index. 


Synchronized method =A method that is controlled by a lock. In order to execute the method, 
the calling thread must acquire the lock. 


Syntax Rules that define how to form instructions in a particular programming language. 
Syntax diagram A graphical representation of grammar rules. 


Syntax error An instruction that does not follow the programming language rules and is 
rejected by the compiler. 


Synchronized block =A block of code that is controlled by a lock. To start execution, a thread 
must acquire the lock. Upon completion, it relinquishes the lock. 


Tab character The '\t' character, which advances the next character on the line to the next 
one of a set of fixed positions known as tab stops. 
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TCP/IP (Transmission Control Protocol/Internet Protocol) ‘The pair of communication protocols 
that is used to establish reliable transmission of data between two computers on the Internet. 


Ternary operator An operator with three arguments. Java has one ternary operator, 
a? Db a: G 


Test coverage The instructions of a program that are executed in a set of test cases. 


Test harness A program that calls a function that needs to be tested, supplying parameters 
and analyzing the function’s return value. 


Test suite A set of test cases for a program. 

Text field A user interface component that allows a user to provide text input. 

Text file A file in which values are stored in their text representation. 

Thread A program unit that is executed independently of other parts of the program. 


Three-tier application An application that is composed of separate tiers for presentation logic, 
business logic, and data storage. 


Throwing an exception Indicating an abnormal condition by terminating the normal control 
flow of a program and transferring control to a matching catch clause. 


throws specifier Indicates the types of the checked exceptions that a method may throw. 


Time slicing Scheduling threads by giving each thread a small amount of time in which to do 
its work, then giving control to another thread. 


Token A sequence of consecutive characters from an input source that belongs together for 
the purpose of analyzing the input. For example, a token can be a sequence of characters 
other than whitespace. 


Total ordering An ordering relationship in which all elements can be compared to each other. 
Trace message A message that is printed during a program run for debugging purposes. 


Transaction A set of database operations that should either succeed in their entirety, or not 
happen at all. 


Tree A data structure consisting of nodes, each of which has a list of child nodes, and one of 
which is distinguished as the root node. 


try block A block of statements that contains exception processing clauses. A try block 
contains at least one catch or finally clause. 


Turing machine A very simple model of computation that is used in theoretical computer 
science to explore computability of problems. 


Two-dimensional array A tabular arrangement of elements in which an element is specified by 
a row and a column index. 


Type A named set of values and the operations that can be carried out with them. 


Type parameter A parameter in a generic class or method that can be replaced with an actual 
type. 

Type variable A variable in the declaration of a generic type that can be instantiated with a 
type. 

Unary operator An operator with one argument. 
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Unchecked exception An exception that the compiler doesn’t check. 


Unicode A standard code that assigns code values consisting of two bytes to characters used 
in scripts around the world. Java stores all characters as their Unicode values. 


Unified Modeling Language (UML) A notation for specifying, visualizing, constructing, and 
documenting the artifacts of software systems. 


Uninitialized variable A variable that has not been set to a particular value. In Java, using an 
uninitialized local variable is a syntax error. 


Unit test A test of a method by itself, isolated from the remainder of the program. 


URL (Uniform Resource Locator) A pointer to an information resource (such as a web page or 


an image) on the World Wide Web. 


User interface component A building block for a graphical user interface, such as a button or 
a text field. User interface components are used to present information to the user and allow 
the user to enter information to the program. 


Value binding In JSF, an expression describing a bean and a property that is to be accessed at 
a later time. 


Variable A symbol in a program that identifies a storage location that can hold different 
values. 


Virtual machine A program that simulates a CPU that can be implemented efficiently on a 
variety of actual machines. A given program in Java bytecode can be executed by any Java 
virtual machine, regardless of which CPU is used to run the virtual machine itself. 


Visual programming Programming by arranging graphical elements on a form, setting pro- 
gram behavior by selecting properties for these elements, and writing only a small amount of 
“glue” code linking them. 


void keyword A keyword indicating no type or an unknown type. 
Watch window A window in a debugger that shows the current values of selected variables. 


Waterfall model A sequential process model of software development, consisting of analysis, 
design, implementation, testing, and deployment. 


Web application An application that executes on a web server and whose user interface is dis- 
played in a web browser. 


White-box testing Testing functions taking their implementations into account, in contrast to 
black-box testing; for example, by selecting boundary test cases and ensuring that all 
branches of the code are covered by some test case. 


Whitespace Any sequence of only space, tab, and newline characters. 
Wrapper class A class that contains a primitive type value, such as Integer. 
Writer In the Java input/output library, a class to which characters are to be sent. 


XML (Extensible Markup Language) A simple format for structured data in which the structure 
is indicated by markup instructions. 
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| (not logical operator), 206, 207, 1119, 1142z 
and De Morgan’s law, 209 


&& (and logical operator), 206, 207, 1120, 
1142t 
contusing with | |, 208 
and De Morgan’s law, 209 
lazy evaluation, 208-209 


| | (or logical operator), 206, 207, 1120, 1142t 
confusing with && 208 
and De Morgan’s law, 209 
lazy evaluation, 208-209 


% operator, 149, 1120 

& operator, 1120 

* operator, 1120 

+ operator, 158, 1120 

- operator, 1120 

= operator, See assignment operator 
A operator, 1120 

| operator, 1120 

>>> operator (bitwise shift right), 1120, 1144 
<< operator (shift left), 1120, 1144 
>> operator (shift right), 1120, 1144 
/ operator, 148-149, 1120 

< operator, 1882, 1120 

<= operator, 1882, 1120 


== operator, 188z, 1120 
comparing objects, 191-192 


don’t use to compare strings, 189, 
190-191 
testing for null references, 192 
> operator, 1882, 1120 
>= operator, 1882, 1120 
!= operator (not equals), 1882, 1120 
don’t use to test end of range 
in loops, 243 


A 
<a> </a> tag pair (HTML), for 
adding links, 1128 
abs method 
java. lang.Math class, 150z, 1077 
abstract classes, 460-461 
abstract data type, 682-685 
abstraction, 82-85 
levels in software design, 84 
abstract keyword, 460, 1121 
abstract methods, 460-461 
syntax, 1109 
Abstract Windowing Toolkit (AWT), 49, 
364t 
accept method 
java.net.ServerSocket class, 898, 1083 
access control, 462-465 
protected access, 464-465 
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accessor methods, 46-47, 341 
clone mutable instance fields in, 472-473 


access specifier 
instance fields, 94 
method, 86 


Accidental Empires, 371 
accidental package access, 463 
AccountTester. java, 456 


acos method 
java. lang.Math class, 150z, 1077 


action events 
from radio buttons, check boxes, and 
combo boxes, 793 


actionPerformed method 
java.awt.event.ActionListener 


interface, 409-410, 412, 415, 1068 
actors, 337 


Ada, 426-427 
and Ariane rocket incident, 520 


addActionListener method 
javax.swing.AbstractButton class, 1096 


addChangeListener method 
javax.swing.JSlider class, 811, 1100 


addFirst method 
java.util.LinkedList class, 667, 
672-673, 1092 


addItem method 
javax. swing. JComboBox class, 792, 1097 


addition, 148 


addLast method 
java.util.LinkedList class, 667, 1092 


add method 

java.awt.Container class, 1065 

java.math.BigDecimal class, 137, 1082 

java.math.BigInteger class, 137, 1083 

java.util.ArrayList class, 293-294, 767, 
1088-1089 

java.util.Collection interface, 1090 

java.util.ListIterator interface, 669, 
7024092 

javax.swing.ButtonGroup class, 791, 1097 

javax. swing. JMenuBar class, 802, 1099 

javax.swing.JMenu class, 802, 1099 

Set interface, 702 


addMouseListener method 
java.awt.Component class, 422, 1065 


Address. java, 555-556 


advanced data structures, 699 
ageregation, 539 

and association, 543-544 

with multiplicities, 543 

UML notation, 540 

UML relationship symbol, 541t, 1146 


AJAX (Asynchronous JavaScript and XML), 
1012-1013 


almost complete tree, 740 
Altair 8800, 370 
American National Standards Institute 


(ANSI), 689 


analysis phase, of software life cycle, 530 
class discovery in, 537 


analytical engine, 649 


and logical operator, 206, 207, 1120 
binary, 1142 
contusing with or operator, 208 
and De Morgan’s law, 209 
lazy evaluation, 208-209 


anonymous classes, 405-406 
anonymous objects, 405-407 


Apache Derby, 933 
GlassFish includes, 1036 


API documentation, 50-52 
Swing documentation, 808-814 


append method 
javax. swing. JTextArea class, 483, 1100 


Apple II, 370 
AppleScript, 476 
AppleTalk protocol, 888 
applets, 10, 63-65 

applet tag (HTML), 1128 


applet viewer, 64-65 
summary, 1132 


application data, 888 
application programmers, 50 
Arabic alphabet, 163 


arcs 
drawing, 61 


args parameter, 502 
Ariane rocket incident, 520-521 
arithmetic operations, 148-153 


arithmetic operators, 43 
combining with assignment, 148 
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ARPANET, 70 
array algorithms, 301-306 
arraycopy method 


java. lang. System class, 311-314, 1081 


ArrayList constructor, 1088 
array lists, 292-297 


abstract and concrete view of, 682-685 


counting matches, 301-302 
finding a value, 302 


finding maximum or minimum, 302-303 


How To work with, 309-310 
number of elements, 297t 

and object streams, 833-834, 837 
parameterized, 297 


ArrayListTester. java, 294-295 
array reference, 289 


arrays, 288-292. See also sorting 
circular, 688, 693 
copying, 311-314 
efficiency of operations, 685t 
How To work with, 309-310 
initialization, 292 
make parallel arrays into arrays of 

objects, 315-316 
multidimensional, 310 
number of elements, 297t 
partially filled, 316-317 
simple algorithms, 301-306 
storing heaps in, 745 
two-dimensional, 306-309 
two-dimensional with variable row 
lengths, 310 

underestimating size of data set, 315 
uninitialized, 292 
using heapsort to sort, 753 
wrappers and auto-boxing, 298-299 


array types, 1107 
ArrayUtil.java, 631 
array variables 
style guide, 1053 
artificial intelligence, 210-212 


asin method 
java. lang.Math class, 1502, 1077 


assertion, 348-349 
assertion checking, 348 
AssertionError, 348 


assert keyword, 1121 
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assignment operator (=), 36-37, 146, 1120 


combining with arithmetic, 148 
association, 543-544 
asymmetric bounds, 252 


atan method 
java. lang.Math class, 150t, 1077 


atan2 method 
java. lang.Math class, 150t, 1077 


ATM. java, 564-567 

ATMFrame. java, 572-574 

ATM machine case study, 556-577 
ATMSimulator. java, 569-571 
ATMViewer. java, 571-572 


attributes 
in UML diagrams, 542 
and XML elements, 967, 970-971 


auto-boxing, 298-299 

autoindent feature, 187 

automotive onboard computers, 881 
auto-wrapping, 299 

await method 


java.util.concurrent. locks.Condition 


interface, 865-866, 869, 1095 


B 
Babbage, Charles, 647-649 


backslash, 161 
in file names, 500 


backup copies, 15 

backup strategy, 15, 16 
BadDataException. java, 519 
balanced trees, 726 


Bank. java, 303-305, 567-568, 902-903, 950 
BankAccount. java, 97-98, 295-296, 457-458, 


860-861, 867-868, 950-952 
BankAccountTester. java, 103 


BankAccountThreadRunner. java, 858 


BankAccountThreadTester. java, 866—867 


BankClient. java, 903-904 
BankData. java, 830-833 

bank database case study, 947-952 
BankServer. java, 900 
BankService. java, 900-902 
BankSimulator. java, 829-830 
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BankTester. java, 305-306, 319-320 
base directory, 366-367, 369 
BASIC, 370 


Basic Latin (ASCII) subset, 
of Unicode, 1058t 


batch files, 321, 445 
BigDecimal constructor, 1082 
BigInteger constructor, 1083 
big numbers, 137 


big-Oh notation, 636, 638-639 
and random access in array lists, 685 


binary and operation, 1142: 

binary format, 820-821 

binary numbers, 137-139, 1136-1138 
binary operators, 1050, 1055, 1108, 1120 
binary or operation, 1142t 


binary search, 651-654, 720 
random access, 666 


BinarySearcher. java, 652-653 


binarySearch method 
java.util.Arrays class, 654, 1089 
java.util.Collections class, 1090 


BinarySearchTree. java, 727-730 


binary search trees, 720-730 
heaps compared, 741 
tree traversal, 731-734 


binary trees, 720, 721 

binary xor operation, 1142t 
BIOS (Basic Input/Output System), 370 
bit operations, 1142-1143 
bits, 820 

bitwise shift right, 1120, 1144 
BLACK, RGB value, 68z 

black boxes, 82-83 
black-box testing, 212, 444 
blank lines, 1055 

block, 412, 1114 

block statement, 184, 185 
BLUE, RGB value, 68z 


Blue], 49, 93, 101 
debugger included, 264 
unit testing built into, 372 


Blu-Ray DVD standard, 690 


body 
if statement, 182 
of method, 20, 86 


Boolean class, 298t 

Boolean constructor, 1074 
Boolean expressions, 205-212 
boolean keyword, 1121 


Boolean operators, 206-208 
De Morgan’s law, 209 
lazy evaluation, 208-209 


boolean type, 135z, 1107 
using, 205 
wrapper class, 298 


booleanValue method 
java. lang.Boolean class, 299, 1074 


Boolean variables 
using, 210 
when termination condition of loop is 
evaluated in middle of loop, 247-248 


border layout, 788, 789 
BorderLayout constructor, 1064 


borders, 791-792 
How To example, 799-801 


boundary test cases, 212-213 
bounded queue, 694 
bounds errors, 290, 291 
brace layout, 185-186 
braces, 20 
forming block statement, 184 
lining up, 185-186 
style guide, 1050, 1056 
brackets, 1055 
break keyword, 1121 
breakpoint, debugger, 264 


break statement, 254-255 
syntax summary, 1116 
when disallowed by style guide, 1050, 
1054 


buckets, 709 
buffer overrun attack, 318 
Buffon needle experiment, 256-261 


bugs, 24. See also debuggers 
electronic voting machines, 111 
first bug, 274-275 


Burroughs, 56 
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bus, 6, 7 
business logic, JSF pages, 1017 
business logic tier, 1034 
ButtonGroup, 791 
buttons, 790-792 
building applications with, 414-418 
How To example, 799-801 
outcome, 1032 
Web applications, 1010 
ButtonViewer. java, 410 
Byte class, 298t 
byte keyword, 1121 
bytes, 820 
encryption, 822 
negative values, 821-822 


byte type, 1352, 1107 
as signed type, 821 
wrapper class, 2982 


C 
CG 
bounds errors, 291 
buffer overrun, 318 
history of, 426, 427 
C++ 
bounds errors, 291 
buffer overrun, 318 
closest rival to Java, 10 
history of, 426, 427 
Java contrasted, 10 
standardization, 689 
static keyword, 353 
Caeser Cipher, 822 
CaeserCipher. java, 823-824 
CaeserEncryptor. java, 824-825 
call: 20, 21 
callbacks 
actionPerformed method as, 409 
using interfaces for, 398-402 
call by reference, 346-347 
call by value, 346-347 
call stack, 520 
camel case, 36 
candidate classes, 536-537 
capitalization, 18 
capitalization check, 25 


1167 


Car.java, 115-116 
CarComponent. java, 114 
CarViewer.java, 116 
case keyword, 1121 


case sensitivity 
of identifiers, 35 
of Java, 17 


case studies 
algorithm animation, 871-880 
ATM machine, 556-577 
bank database, 947-952 
invoice printing, 544-556 
CashRegister. java, 143-144 
CashRegisterSimulator. java, 166 
CashRegisterTester. java, 144 
cast, 136 
to convert from interface type to 
class type, 396 
for implementing linked lists, 671 
to recover Graphics2D object from 
Graphics parameter, 61 


catch clause, 509-511 
don’t use catch and finally in same 
try statement, 513 


catching exceptions, 508-511 
catch keyword, 1121 


catch statement, 508-511 
use spaces around (. . .) part, 1055 


ceil method 
java. lang.Math class, 150t, 1077 


CENTER component, BorderLayout, 788, 789 
central processing unit (CPU), 4, 6, 7 
Character class, 298¢ 
characters, 820 
char keyword, 1121 
char type, 1352, 1107 

and strings, 162 

wrapper Class, 298¢ 
check boxes, 791 

How To example, 799-801 

JSF components, 1030z 
checked exceptions, 506-508 
CheckingAccount. java, 458-459 
Chinese script, 163-165 


chips, 4 
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circles 
drawing, 66-67 
How To draw, 117 
circular array, 688, 693 
circular linked list, 693 
CityZone.sql, 1035 
class diagrams, 339 


classes, 18-20, 33, 38-39. See also 
inheritance; inner classes 
access control, 462-465 
anonymous, 405-407 
building to carry out 
computations, 155-157 
choosing, 336-337 
cohesion and coupling, 338-341 
commenting, 90-91 
CRC card method, 537-538 
designing public interface, 85-90, 99 
discovering, 536-538 
How To implement, 99-101 
immutable, 341 
implementing constructors 
and methods, 95-101, 101 
instance fields, 93-95, 100 
location, 366-367 
as reference types, 1107 
relationships between, 536, 539-542 
scope of members, 359-360 
style guide, 1051 
syntax summary, 1109-1110 
testing, 101 
UML notation, 1145 


class fields, 354 

class files, 25 

class invariants, 351-352 
class keyword, 1121 
class methods, 352 


class names, 36 

in packages, 1117 

style guide for, 1050, 1055 
class path, 366-367 


class type 


converting to interface type, 395-396 


ClickListener. java, 409 

client program, 894-897 
client-server architecture, 1035 
client-server programs, 904-905 


clipboard, 407 


clone method 
array copying, 311-312 
forgetting to, 472 
implementing, 473-475 


java 
java 


.lang.Enum class, 476 
.lang.Object class, 465t, 472, 1079 


close method 


java 
java 
java 
java 
java 


java. 
java. 
java. 
java. 
java. 
java. 
java. 


.io. InputStream class, 1071 
.io.OutputStream class, 1072 
.io.PrintWriter class, 498, 511, 1073 
.io. Reader class, 1074 

.io.Writer class, 1074 
net.ServerSocket class, 898, 1083 
net.Socket class, 895, 1084 
sql.Connection class, 939 
sql.Connection interface, 1085 
sql.ResultSet interface, 1086 
sq].Statement interface, 941, 1087 
util.Scanner class, 498, 1094 


CMS-2, 426 

code reuse, See reuse 

code unit, 162 

coding guidelines, 1049-1056 

coding standards, 534 

cohesion, 338-341 

Coin.java, 717-718 
CoinHashCodePrinter. java, 718-719 
collaborators, in CRC cards, 537-538 


collections 
style guide, 1053 
use type parameters, not raw types, 1053 


collective ownership, 534 


collision, hashing, 708 


Color constructor, 1064 


colors, 67—70 
RGB values of predefined, 68t 


color viewer, 808 


Colorvi 
ColorvVi 


ewer. java, 812 


ewerFrame. java, 812-814 


columns, in relational database 
tables, 916-917 
don’t replicate, 924 
selecting, 926-927 


combo boxes, 791, 792-794 
comma, 1055 
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command line arguments, 19-20, 502-503 
command line editing, 104 
command line interface, 104 


comments, 20 
alternative syntax, 22 
style guide, 1050 
syntax summary, 1118 
commercial databases, 933 


commit method 
java.sql.Connection class, 953 
java.sql.Connection interface, 1085 


Common Object Request Broker 
Architecture (CORBA), 364 


compact discs (CDs), 6, 7 
saving backups to, 15, 16 


Comparator interface, 657-658 


compare method 
java.util.Comparator interface, 1090 


compareTo method 
can return any integer, 656 
Comparable interface, 655, 656, 778, 1075 
java.lang.String class, 189-190, 191, 
1080 


comparisons 

comparing values, 188-192 

sequences of, 193-195 
compiler 

common options, 1131t 

locating, 13-14 

and parsers, 980-981 

summary of, 1130-1131 

translating programs into 

machine code, 9 

compile-time errors, 23-24 
compiling 

compilation process, 25-27 

edit-compile-test loop, 26-27 

simple program, 17-21 
components 

adding to frames, in drawing 

shapes, 59-62 

zero width and height by default, 487 

compound statement, 184 


computation 
How To carry out, 155-157 
limits of, 532, 608-611 


computer graphics, 121-122 
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computerization, 1043 
computer monitor, 6, 7 
computer programming, 2-3. See also 
generic programming 
defensive, 24 
computer programs, 2-3. See also errors 
compiling simple, 17-21 
translating to machine code, 8-9 
computers 
anatomy of, 3-7 
becoming familiar with, 12-16 
ENIAC, 8 
mainframes, 56—57 
need for programming, 2 
personal, 370-372 
schematic diagram, 7 
using to get organized, 1043 
computer viruses, 318-319 
computing, 7 
concatenation, 158, 466 
concrete classes, 460 
concrete data type, 682-685 
condition objects, for controlling 
threads, 864-865 
conditions 
avoiding side effects, 193 
do loops, 234 
if statement, 182 
while loops, 228 
connection pooling, 1036 
consistency, 340 
constants, 140-145 
in interfaces, 394 
style guide, 1052-1053 
style guide for naming, 1050, 1054 
constr keyword, 1121 
construction, 45 
arrays, 290 


construction parameters, 45 


constructors, 44-46, 87-89, 1051 
calling one from another, 110 
forgetting to initialize object 

references, 106-107 
implementing, 95-101, 101 
methods contrasted, 46 
syntax summary, 1113-1114 
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containers 
don’t use as an event listener, 417-418 
How To choose, 737-738 


contains method 
java.util.Collection interface, 1090 
Set interface, 702 
content pane, /89 
continue keyword, 1121 
continue statement, 254-255 
syntax summary, 1116 
when disallowed by style guide, 1050, 
1054 
continuous integration, 534 
control characters, 1057t 
Control Data, 56 
control flow 
style guide, 1053-1054 
cookies, 1028-1029 
copy and paste, in editor, 196-197 
correctness proofs, 263 
cos method 
java. lang.Math class, 150z, 1078 
coupling, 339-340 
interfaces to reduce, 391 
CRC card method, 537-538 
ATM case study, 558-561 
invoice printing case study, 545-547 
and UML diagrams, 541-542 


createElement method 
org.w3c.dom.Document interface, 
981-982, 1104 
createLSSerializer method 
org.w3c.dom.1s.DOMImplementationLS 
interface, 983, 1105 
createStatement method 
java.sql.Connection class, 953 
java.sql.Connection interface, 1085 
CREATE TABLE command (SQL), 917 


createTextNode method 
org.w3c.dom.Document interface, 
983, 1104 


cryptography package, 12 
current directory, 367 


currentTimeMi1llis method 
java. lang.System class, 632, 1081 


Customer. java, 568—569 


CYAN, RGB value, 68¢ 
cycling, 319 
CYC Project; 211 


D 
dangling else problem, 202-203 


DARKGRAY, RGB value, 682 


DARPA (Defense Advanced Research 
Projects Agency), 70 


DataAnalyzer. java, 248, 515-516 
database management systems (DBMS), 915 
database.properties (Apache Derby), 938 


database queries, 925 
calculations, 928 
case study: bank database, 947-952 
column selection, 926-927 
delimiters in manually constructed, 942 
joins, 928-931 
let the database do the work, 944 
results analysis, 943 
result set meta data, 944-947 
simple queries, 926 
subset selection, 927-928 
updating and deleting data, 931 


database replication, 919-920 
avoid unnecessary, 921 


databases 

connecting to, 939-940 

don’t hardwire connection 
parameters into, 940-941 

installing, 933-938 

pooled connections in three-tier 
applications, 1036 

privacy concerns, 932-933 

programming in Java, 939-947 

as storage tier in three-tier 
applications, 1034 

transaction handling, 952-953 


database storage package, 12 


database tables, 916-918 
linking, 918-922 
multi-valued relationships, 922-924 
object-relational mapping, 954-955 


DataSet. java, 248-249, 400-401 
DataSetReader. java, 518-519 
DataSetTester. java, 393, 401 
DataSetTester3. java, 404-405 
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data storage, 4-5, 6, 7 
data structures, 665, 666. See also binary 
search; binary search trees; linked lists 

abstract and concrete data types, 682-685 
advanced, 699 
interface references, 704—705 
self-organizing, 725 
stacks and queues, 686-688 


Date method 
java.util.Date class, 1091 


datetime/index.jsp, 1014 
datetime/WEB-INF/faces-config.xml, 1016 
datetime/WEB-INF/web. xml, 1019 
deadlock, 864-871 

deadly embrace, 864 


debuggers, 24 
can’t show program is bug-free, 272 
preferred to logging messages, 448 
recursive methods, 520 
sample session, 267-274 
using, 264—267 

decimal notation, 1136 

decimal numbers, 137 


decisions, 182. See also boolean operators; 
if statement 
comparing values, 188-192 
multiple alternatives, 193-204 
nested branches, 198-201 


decrement operator (--), 146, 1119 
default keyword, 1121 

default package, 365 

defensive programming, 24 

DELETE command (SQL), 931 

De Morgan’s law, 209 


dependency, 338-340, 540 
UML relationship symbol, 5412, 1146 


deployment phase, of software life cycle, 
530; 551 


DepositRunnable. java, 858-859 

design phase, of software life cycle, 531 
desktop databases, 933 

destination address, 889 


destroy method 
java.applet.Applet class, 1064 
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diagrams, 121 
dialog boxes 
using for input and output, 169 
Die. java, 257 
DieSimulator. java, 257-258 
ditference engine, 647-648 
Dimension constructor, 1065 
directories, 14-15 
disk controller, 7 
divide-and-conquer technique, in 
debugging, 273 
divide method 
java.math.BigInteger class, 1083 
division, 148 
documentation comments, 90, 1118 
generating from commented 
source code, 1135 
setting in source code, 1133-1134 


document type definitions (DTD), 988-993 
How To write XML, 996-998 
specifying in XML document, 993-994 


do keyword, 1121 


do loops, 234-235 
break and continue, 254-255 
syntax summary, 1116 


domain names, 889 
Domain Naming Service (DNS), 889 


DOM (Document Object Model) 
parsers, 972, 980 


dongles, to prevent software piracy, 738 
DOS (Disk Operating System), 371 

dot symbol, 368 

Double class, 298t 

Double constructor, 1076 

double keyword, 1121 

double precision floating-point number, 43 


double type, 43, 135t, 1107 
not appropriate for financial 
calculations, 135-136 
wrapper class, 298 
doubleValue method 
java. lang.Double class, 299, 1076 
doubly linked list, 669 


Dr. Java, 50 
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draw method 
java.awt.Graphics2D class, 61, 66, 119, 
1066 


drawString method 
java.awt.Graphics2D class, 67, 1066 


DROP TABLE command (SQL), 917 
DSL modem, 888 


DVD standards, 690 
dynamic binding, 1113 


E 

early binding, 398 

Earthquake. java, 193-194 
EarthquakeRunner. java, 194-195 

EAST component, BorderLayout, 788, 789 


Eclipse, 264, 446 
unit testing built into, 372 


E constant, java. lang.Math class, 142, 1079 
editable combo boxes, 792 
edit-compile-test loop, 26-27 
editor, 25 

copy and paste in, 196-197 
electronic mail, 70, 887, 890 
electronic voting machines, 110-112 


element content, XML, 967 
regular expressions for, 990t 


element variable, 300 
Ellipse2D.Double constructor, 1068 
ellipses 

drawing, 61, 65-66 

How To draw, 117, 118 
ellipsis, 1107 
else alternative, 183, 184 

dangling else problem, 202-203 
else keyword, 1122 
e-mail, 70, 887 

TCP used by, 890 
embedded-systems, 880-881 
embedded-systems software, 426 
EmptyFrameViewer. java, 59 
empty strings, 158 
encapsulation, 83, 95 
encryption, 822-825 
encryption algorithms, 825-827 


encryption key, 822 
English alphabet, 163 


ENIAC (electronic numerical integrator 
and computer), 7-8 


Gensures tag, 350 
enterprise edition, of Java library, 10 


enumerated types, 204, 475-476 
as reference types, 1107 


enum keyword, 1122 
EOFException constructor, 1070 


epsilon, threshold for floating-point 
numbers, 189 


equality testing, 188 
equal operator, 188 


equalsIgnoreCase method 
java.lang.String class, 189, 1080 


equals method 
defining with wrong parameter type, 470 
and inheritance, 470-471 
java. lang.Enum class, 476 
java.lang.Object class, 191, 192, 465z, 

1079 

java.lang.String class, 189, 1080 
overriding, 468-469 


erasing, type variables, 780, 781 
error conditions, 214 
error.jsp, 1038 


errors, 23-25. See also debuggers 
checking for in compilation process, 27 
reproducing in debuggers, 273 


escape characters, 500 

escape sequences, 161-162 
EtchedBorder constructor, 1101 
European Computer Manufacturers 


Association (ECMA), 690 


evaluate method 
javax.xml.xpath.XPath interface, 974, 
1103 


Evaluator. java, 536-537 
event adapters, 425-426 
event handler classes, 486 


event listeners, 407-410, 486-487 
don’t use containers as, 417-418 
forgetting to attach, 417 
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events, 408 
processing timer, 418-421 
event sources, 408 
exception class hierarchy, 504 
exception handler, 505 
exception handling, 503 
case study example, 515-519 
catching exceptions, 508-511 
checked and unchecked 
exceptions, 506-508 
finally clause, 511-513 
throw early, catch late, 510 
throwing exceptions, 503-505 
exception reports, 160-161 
exceptions 
designing your own types, 513-515 
don’t squelch, 511 
style guide, 1054 
syntax summary, 1116-1117 
throw specific, 514-515 
ExecSQL.java, 945-946 
executable program, 1050 


execute method 
java.sql.PreparedStatement interface, 
941, 1086 
java.sql.Statement interface, 941, 1087 
executeQuery method 


java.sql.PreparedStatement interface, 
941, 1086 
java.sql.Statement interface, 941, 1088 


executeUpdate method 
java.sql.PreparedStatement interface, 
941, 1086 
java.sql.Statement interface, 941, 1088 


exists method 
java.io.File class, 501, 1070 


exit method 
java. lang.System class, 1081 


expert systems, 211 
explicit parameters, 40, 107-108 


exp method 
java. lang.Math class, 150z, 1078 


exponential notation, 43 
ExpressionCalculator. java, 538-539 


expressions 
in statements, 1114 
syntax summary, 1108-1109 
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expression syntax diagram, 533 
ExpressionTokenizer. java, 537-538 
expression trees, 733 


extends keyword, 1122 
and type variables, 778 


Extensible HyperText Markup Language 
(XHTML), 999, 1126 


Extensible Markup Language, See XML 


extension, 14 
. Java extension, 14 


Extreme Programming, 533-534 
Extreme Programming (Brock), 533 


F 

FaceComponent. java, 69 
faces-config.xml, 1016, 1025, 1042 
FaceViewer. java, 69-70 

factor syntax diagram, 533 

false, boolean type, 205 

Federal Tax Rate Schedule, 199z 
fence post error, 253 

Fibonacci sequence, 526 


field declaration 
classes, 1109 
interfaces, 1110-1111 


fields, 93 

Fifth-Generation Project, 211 

file completion, 104 

File constructor, 1070 

file dialog boxes, 500-501 

Fi leInputStream constructor, 1070 
file management, 406 

file names, 500, 501 
FileNotFoundException, 499, 507, 516 
file objects, 500-501 
FileOutputStream constructor, 1071 
file pointer, 827-828 

file protocol, 1128 

FileReader constructor, 1071 


files, 14-15 
encryption, 822-825 
How To use, 836-837 
object streams, 833-835 
random access, 827-833 
reading and writing text files, 498-501 
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file system, 15-16 
FileWriter constructor, 1071 


£111 method 
java.awt.Graphics2D class, 67, 1066 


final classes, 461, 1110 
final keyword, 1122 


finally clause, 511-513 
don’t use catch and finally in same try 
statement, 513 


finally keyword, 1122 
final methods, 461 
final variable, 141, 412 
first in, first out (FIFO), 686 
fixing the heap, 744, 751 
flags 
Boolean variables, 210 
format, 167, 168 


Float class, 298t 


floating-point numbers, 43 
comparing, 188-189 
converting to binary, 138 

float keyword, 1122 


float type, 135t, 1107 
wrapper class, 298t 


floor function, 156 


floor method 
java. lang.Math class, 150z, 1078 


floppy disks, 6 

saving backups to, 15, 16 
flow layout, 788 
FlowLayout constructor, 1066 
folders, 14-15 
Font constructor, 1066 
fonts, 407, 803 
FontViewer. java, 7/94 
FontViewer2.java, 803 
FontViewerFrame. java, 795-798 
FontViewer2Frame. java, 804-807 


for each loops, 300-301, 702, 1053 
and Iterable interface, 670-671 
syntax summary, 1115 

foreign key, 920 

for keyword, 1122 


for loops, 237-244 
break and continue, 254-255 
counting number of iterations, 252-253 
enhanced, 300-301 
How To implement, 252 
scope of variables defined in 
header, 243-244 
syntax summary, 1115 
use for intended purpose only, 241 


formal process, of software development, 
530 


format flags, 167, 168 


format method 
java.lang.String class, 1080 
java.text.DateFormat class, 1023, 1088 


format specifiers, 167 

format string, 167 

format types, 168¢ 

forms, for Web applications, 1010-1011 


forName method 
java. lang. Class class, 1075 


for statement 

style guide, 1053-1054 

use spaces around (...) part, 1055 
frames, 58-59 

drawing shapes in, 59-62 

using inheritance to customize, 478-480 
free-form layout, 17-18 


f:selectItems tag, JSF components, 
1030-1031 


FTP (file transfer protocol), 1128 
URLConnection class, 905 


functional programming languages, 345 


G 


garbage collector, 105 
linked lists, 673 


General Electric, 56 


generic classes, 293 
defined, 766 
implementing, 768-775 
instantiating, 767 

generic fields 
type variables for, 769 


genericity, 778 


Index 


generic methods, 776-777 
syntax summary, 1118 
generic programming 
defined, 766 
type variables, 766-767 
generic types, 780 
interfacing with legacy code, 780 
in static context, 782 
syntax summary, 1118 


German characters, 163 


getAttribute method 
org.w3c.dom.Element interface, 995, 1104 


getAvailableIDs method 
java.util.TimeZone class, 1022, 1095 


getCenterX method 
java.awt.geom.RectangularShape class, 


1070 


getCenterY method 


java.awt.geom.RectangularShape class, 
1070 


getColumnCount method 
java.sql.ResultSetMetaData interface, 
944, 1087 


getColumnDisplaySize method 
java.sql.ResultSetMetaData interface, 
944, 1087 


getColumnLabel method 
java.sql.ResultSetMetaData interface, 


944, 1087 


getConnection method 
java.sql.DriverManager class, 939, 1085 


getContentLength method 
java.net.URLConnection class, 907, 1084 


getContentType method 
java.net.URLConnection class, 907, 1084 


getDomConfig method 
org.w3c.dom.1s.LSSerializer 
interface, 1105 


getDouble method 
java.sql].ResultSet interface, 943, 1086 


getFeature method 
org.w3c.dom.DOMImplementation 


interface, 983, 1104 
getFilePointer method 
java.io.RandomAccessFi le class, 


828, 1073 
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getFirst method 
java.util.LinkedList class, 667, 1092 


getHeight method 
java.awt.Component class, 114, 1065 
java.awt.geom.RectangularShape 
class, 1069 
java.awt.Rectangle class, 46, 1067 


getImplementation method 
org.w3c.dom.Document interface, 
983, 1104 


getInputStream method 
java.net.Socket class, 894, 1084 
java.net.URLConnection class, 
905-906, 1084 


getInt method 
java.sql.ResultSet interface, 943, 1086 


getLast method 
java.util.LinkedList class, 667, 1092 


getLogger method 
java.util. logging.Logger class, 448, 
1096 


getMaxxX method 
java.awt.geom.RectangularShape 


class, 1070 


getMaxY method 
java.awt.geom.RectangularShape 


class, 1070 


getMessage method 
java. lang. Throwable class, 514, 1082 


getMetaData method 
java.sql].ResultSet interface, 944, 1087 


get method 
java.util.ArrayList class, 293, 685, 1089 
java.util.Calendar class, 1089 
java.util.Map interface, 706, 1093 
getMinX method 
java.awt.geom.RectangularShape 
class, 1070 
getMinY method 
java.awt.geom.RectangularShape 
class, 1070 
getOutputStream method 
java.net.Socket class, 894, 1084 
getProperty method 
java.util.Properties class, 940, 1093 
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getResponseCode method 
java.net.HttpURLConnection class, 907, 
1083 


getResponseMessage method 
java.net.HttpURLConnection class, 907, 
1083 


getResultSet method 
java.sql.Statement interface, 942, 1088 


getSelectedFile method 
javax.swing.JFileChooser class, 501, 
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getSelectedItem method 
javax. swing. JComboBox class, 793, 1097 


getSource method 
java.util.Collections class, 811 
java.util.EventObject class, 1091 
getString method 
java.sql.ResultSet interface, 943, 1087 
getText method 
javax.swing.JTextComponent class, 
480-481, 1102 
getTimeInstance method 
java.text.DateFormat class, 1088 


getTimeZone method 

java.util.TimeZone class, 1023, 1095 
getUpdateCount method 

java.sql.Statement interface, 942, 1088 
getValue method 

javax.swing.JSlider class, 811, 1100 
getWidth method 

java.awt.Component class, 114, 1065 

java.awt.geom.RectangularShape class, 

1069 
java.awt.Rectangle class, 46, 1067 


~ getX method 


java.awt.event.MouseEvent class, 1068 
java.awt.geom.Point2D class, 1069 
java.awt.Rectangle class, 46, 1067 
getX1 method 
java.awt.geom.Line2D class, 1069 
getX2 method 
java.awt.geom.Line2D class, 1069 
getY method 
java.awt.event.MouseEvent class, 1068 
java.awt.geom.Point2D class, 1069 
java.awt.Rectangle class, 46, 1067 


getY1 method 
java.awt.geom.Line2D class, 1069 


getY2 method 
java.awt.geom.Line2D class, 1069 


GlassFish, 1017, 1018 
Derby database included with, 1036 
global search and replace, 362 
GNU project, 70 
Google Maps, 1012-1013 
goto keyword, 1122 
goto statement, 236 
grammars, 978-979 
graphical applications, 58-59 
colors, 67-70 
drawing complex shapes, 68-70, 112-120 
drawing shapes, 59-62 
frame windows, 58-59 
placing text, 67 
graphical shapes, 65-70 
drawing complex, 68-70, 112-120 
How To draw, 117-120 


graphical user interfaces (GUIs) 
choices, 790-802 
file dialog boxes, 500-501 
How To implement, 486-487 
layout management, 788-790 
layout management How To, 799-801 
menus, 802—807 
Swing documentation, 808-814 
text areas, 483-485 
using GUI builder, 801-802 
using inheritance to customize frames, 
478-480 


graphics card, 7 

graphics package, 12 

GRAY, RGB value, 68z 

greater than operator, 188z, 1120 
greater than or equal operator, 1882, 1120 
Greek alphabet, 163 

GREEN, RGB value, 68t 
GreetingRunnable. java, 848-849 
GreetingThreadRunner. java, 849-850 
GregorianCalendar constructor, 1091 
grep program (Unix), 362 

grid bag layout, 789 


index 


erid layout, 788, 789 

GridLayout constructor, 1067 

GUI builder, 801-802 

GUIs, See graphical user interfaces 


H 

halt checker, 686 

halting problem, 608-610 

hard disks, 4, 5, 6, 7 

has-a relationship, 539. See also aggregation 


hash codes, 707-708 
computing, 715-719 
forgetting to define, 719 
and overriding toString method, 466 


hash function, 707-708 
hashing, 707 

HashMap constructor, 1091 
HashSet. java, 710-714 
HashSet constructor, 1091 
HashSetDemo. java, 714 
hash tables, 701, 707-714 


hasNextDouble method 
java.util.Scanner class, 206, 1094 


hasNextInt method 
java.util.Scanner class, 206, 1094 


hasNextLine method 
java.util.Scanner class, 1094 


hasNext method 


java.util.Iterator interface, 669, 
702, 1091 
java.util.Scanner class, 1094 


hasPrevious method 
java.util.ListIterator interface, 
669, 1092 


HD DVD standard, 690 
head, of queue, 686 
HeapDemo. java, 749-750 
heap property, 740 

heaps, 740-750 

heapsort algorithm, 751-756 
HeapSorter. java, 754-756 
Hebrew alphabet, 163 
Hello, World!, 17-21 


HelloPrinter. java, 17-21 
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Hewlett-Packard calculators, 734-735 
hexadecimal numbers, 1141 

high-level libraries, 909 

high-level programming languages, 9 
Honeywell, 56 

HTML attributes, 1126, 1128z 
HTML documentation, 93 

HTML entities, 1129 


HTML (HyperText Markup Language), 
689, 891 
generation from JSF pages, 1015-1016 
HTTP contrasted, 892-893 
summary, 1125-1129 
XML contrasted, 963-964 


HTML markup tags, 965, 966, 1125-1129, 
1127¢t 


HTML tag pairs, 963 
HTTP Get command, 892-893 


HTTP (HyperText Transmission 
Protocol), 689 
and HTML, 1128 
HTML contrasted, 892-893 
as stateless protocol, 1028 
using, 890-894 
HyperText Markup Language, See HTML 


i 

IBM, 56-57 

IBM DB2, 933 

IBM PC, 370-371 

ID cards, security concerns, 933 
identifier, 35 

IEEE floating-point numbers, 1139-1140 
if/else statement, 183-184, 187 

if keyword, 1122 


if statement, 182-187 
comparing values, 188-192 
dangling else problem, 202-203 
nested branches, 198-201 
style guide, 1053 
syntax summary, 1114-1115 
use spaces around (...) part, 1055 


Il legalArgumentException, 503, 505 


Il legalArgumentException 
constructor, 1076 
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I1legalMonitorStateException, 869 
I1legalStateException, 503 
image, JSF component, 1030¢ 
Imagelcon constructor, 1097 
img tag (HTML), 1126 
immutable classes, 341 
implementation, 85 
interface types, 390-391, 392 
implementation phase, of software 
life cycle, 530, 531 
implements keyword, 1122 
implicit parameters, 40, 107-108 
tying to call method without, 109 
import keyword, 1122 
import statement, 1050 
implementing a test program, 49 
Java packages, 365 
increment operator (++), 146, 1119 
indentation 
style guide, 1055 
and tabs, 186-187 
index file 
and primary keys, 921-922 
index. jsp, 1014, 1025-1026, 1037 
index variable, 300 
infinite loops, 232-233 
infinite recursion, 516 


info method 


java.util. logging.Logger class, 215, 
448, 1096 


information loss, 136 


inheritance, 438-442, 539 
to customize frames, 478—480 
and equals method, 470-471 
and genericity, 778 
and generic programming, 766 
instance fields and methods, 445-450 
and toString method, 467-468 
UML notation, 540 


UML relationship symbol, 5412, 1146 


inheritance hierarchies, 443-445 
initialization 
alternative forms of field, 357 
arrays, 292 


forgetting to initialize object 
references, 106-107 
static fields, 355-356 


initialization blocks, 357, 1109 


init method 
java.applet.Applet class, 1064 


inner classes, 66, 403-405, 1051 
as event listeners, 411-414 
and reuse, 387 
static, 682 
and surrounding variables, 412 
inorder traversal, 732 
input 
processing text input, 480-483 
reading, 165-166 
reading from dialog box, 169 


input devices, 6, 7 

input redirection, 320 
InputStreamReader constructor, 1071 
INSERT INTO command (SQL), 917 
insertion sort, 637-638 

insert positions, 725 


instance fields, 93-95, 104-106, 1051 
abstract classes and methods, 461 
clone mutable in accessor 

methods, 472-473 
determining, 100 
implicit parameter, 108 
shadowing, 449-450 
subclasses, 439 
syntax summary, 1110 


instance methods, 352, 1051, 1112 
polymorphic, 397 

instanceof keyword, 1122 

instanceof operator, 454, 1120 

instance variables, 104 


instantiation, 767 
interfaces, 396 


Integer class, 298t 
Integer constructor, 1076 
integer division, 151-152 
integers, 43 
converting to binary numbers, 138 
integrated circuits, 4 
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integrated development environment, 13 
Intel Corporation 

Pentium floating-point bug, 139-140 
interactive environments 

testing classes in, 49-50 


interactive testing, 49, 102 
interface implementation 
ATM case study, 563-577 
invoice printing case study, 550-556 
UML relationship symbol, 5412, 1146t 
interface keyword, 1122 
interface references, 704-705 


interfaces, 387. See also graphical user 
interfaces; user interface 
for code reuse, 388-393 
constants in, 394 
instantiation, 396 
processing timer events, 418-421 
as reference types, 1107 
style guide for naming, 1055 
syntax summary, 1110-1111 
using for callbacks, 398-402 


interface types, 388-392 

converting to class types, 395-396 
interface variables, 396 
international alphabets, 163-165 
International Organization for 

Standardization (ISO), 689 

Internet, 7, 887, 888 

application level protocols, 890-894 

client program, 894-897 

evolution of, 70-71 

high-level libraries, 909 

How To client-server program 

design, 904-905 

saving backups to, 15 

server program, 897-904 

URL connections, 905-909 
Internet access points, 888 
Internet Bubble of 2000, 1043 
Internet Explorer, 71 

viewing applets, 65 
Internet Protocol (IP), 888-890 
Internet Service Providers (ISPs), 888 
Internet worm, 318-319 


interpretation 
of code by Web browser, 1125 
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interprocess communication, 407 
InterruptedException, 848, 853, 854 


interrupted method 
java. lang. Thread class, 848, 
852-853, 1082 


intersection method 
java.awt.Rectangle class, 1067 


int keyword, 1122 
int type, 43, 1352, 1107 
wrapper class, 298 


jntValue method 
java. lang. Integer class, 299, 1076 


Investment. java, 229-230, 239-240 
InvestmentFrame. java, 481-483, 484-486 
InvestmentRunner. java, 230-231, 240 
InvestmentViewerl. java, 413-414 
InvestmentViewer2. java, 416-417 
InvestmentViewer3. java, 481 
Invoice. java, 552-553 
InvoicePrinter. java, 552 

invoice printing case study, 544-556 
invoking programs from command line, 502 


is-a relationship, 392, 539. See also 
inheritance 
isDigit method 
java. lang.Character class, 206, 1075 


isEditable method 
javax. swing. JComboBox class, 792, 1097 
javax.swing.text.JTextComponent 
class, 1102 


isLetter method 
java. lang.Character class, 206, 1075 


jsLowerCase method 
java.lang.Character class, 206, 1075 


isSelected method 


javax.swing.AbstractButton class, 791, 
793, 1096 


i sUpperCase method 
java. lang.Character class, 206, 1075 


ItemListBuilder. java, 983-985 
ItemListBui lderDemo. java, 985-986 
ItemListParser. java, 975-976 
TtemListParserDemo. java, 976-977 
Iterable interface, 670-671 
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iteration, 227. See also for loops; loops; 
while loops 


jterator method 
Collection interface, 1090 
Set interface, 702 


J 


Japanese script, 163 
JAR (Java Archive) files, 1132 


Java, 427 
bit operations, 1142-1143 
coding style guide, 1049-1056 
development history, 10-12 
as high-level programming language, 9 
memory model, 871 
not specifically designed for students, 11 
operator summary, 1119-1120 
shift operations, 1144 
standardization, 689-690 
syntax summary, 1107-1118 
version history, 12t 

Java 1.0, 12¢ 

Java 1.1, 12t 

lava 1.2, 12 

Java 1.3, 12¢ 

Java 1.4, 12 

Java 5.0, 11, 12¢ 
array lists, 299 
enhanced for loops, 300 
enumerated types, 204 
locks, 861, 870 


new Scanner class, 165 

static imports, 363 
Java 6, 12z 

constructors for JSlider class, 810 

GroupLayout, 802 

includes Apache Derby, 934 
java.applet.Applet class 

method summary, 1064 
java.applet package, 364, 1064 
Java applets, 10, 63-65 
Java Archive (JAR) files, 1132 
java.awt.BorderLayout class 


method summary, 1064 
using, 788-789 


java.awt.Color class 

for graphical applications, 67-70 

method summary, 1064 
java.awt.Component class 

method summary, 1065 
java.awt.Container class 

method summary, 1065 
java.awt.Dimension class 

method summary, 1065 
java.awt.event.ActionEvent interface, 412 
java.awt.event.ActionListener interface 

buttons, 414-418 

method summary, 1068 
java.awt.event.MouseEvent class 

method summary, 1068 
java.awt.event.MouseListener interface 

method summary, 1068 

using, 421-422 
java.awt.event package, 1068 
java.awt.FlowLayout class 

method summary, 1066 

using, 788 
java.awt.Font class 

method summary, 1066 
java.awt.Frame class 

method summary, 1066 
java.awt.geom.E11lipse2D.Double class 

drawing ellipses, 65-66 

method summary, 1068 
java.awt.geom.E]llipse2D.Float class 

drawing ellipses, 65-66 
java.awt.geom.Line2D class 

method summary, 1069 
java.awt.geom.Line2D.Double class 

drawing lines, 67 

method summary, 1069 
java.awt.geom package, 1068-1070 
java.awt.geom.Point2D class 

method summary, 1069 
java.awt.geom.Point2D.DoubTe class 

method summary, 1069 
java.awt.geom.RectangularShape class 

method summary, 1069-1070 
java.awt.Graphics class, 60, 61 

method summary, 1066 
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java.awt.Graphics2D class, 60-61 
method summary, 1066 


java.awt.GridLayout class 
method summary, 1067 
using, 788 

java.awt package, 3641, 1064-1067 


java.awt.Rectangle class 
API documentation for, 50-52 
constructing objects, 44-46 
implementing test program, 47-49 
method summary, 1067 

java.awt. Shape interface 
method summary, 1067 


Java Beans, 1020-1029 
designing, 1027-1028 


Java compiler, See compiler 


javadoc utility, 93 
copies first sentence of comments to 
summary table, 90, 91-92 
using to generate documentation 
comments, 1133-1135 


Java-enabled browsers, 65 


java.io. EOFException class, 504 
method summary, 1070 


java.io.File class 
and file dialog boxes, 501 
method summary, 1070 


java.io.FileInputStream class 
method summary, 1070 
and text format, 820, 821 


java.io.FileNotFoundException class, 504 
catching, 509, 510 
method summary, 1070 


java.io. FileOutputStream class 
method summary, 1071 
and text format, 820, 821 


java.io.FileReader class 

method summary, 1071 

reading and writing text files, 498 

and text format, 820 
java.io.FileWriter class 

method summary, 1071 

and text format, 820 
java.io.InputStream class 

method summary, 1071 

and text format, 821 
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java.io. InputStreamReader class 
method summary, 1071 


java.io. IOException class, 504 
as checked exceptions, 506 
method summary, 1072 


java.io.ObjectInputStream class 
method summary, 1072 
and object streams, 833-834 


java.io.ObjectOutputStream class 
method summary, 1072 
and object streams, 833-834 


java.io.OutputStream class 
method summary, 1072 
and text format, 820 


java.io package, 3641, 1070-1074 


java.io.PrintStream class, 25, 38 
method summary, 1072-1073 


java.io.PrintWriter class 
method summary, 1073 
reading and writing text files, 498 
java.io.RandomAccessFi le class 
method summary, 1073-1074 
using, 827-829 
java.io.Reader class 
method summary, 1074 
and text format, 821 
java.io.Serializable interface 
method summary, 1074 
and object streams, 834 
java.io.Writer class 
method summary, 1074 
java. lang.ArithmeticException class, 504 
java. lang. ArrayIndexOutOfBounds- 
Exception class, 504 
java. lang.Boolean class 
method summary, 1074 
java. lang.Character class 
method summary, 1075 
java. lang.ClassCastException class, 504 
java. lang.Class class 
method summary, 1075 
java. lang.ClassNotFoundException 
class, 504 
and object streams, 833 
java. lang.Cloneable interface 
method summary, 1075 
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java. lang.CloneNotSupportedException 
class, 504 
method summary, 1075 


java. lang.Comparable interface 
as generic type, 777-778, 780 
method summary, 1075 
parameterized, 656-657 
and sorting of real data, 654-656 


java. lang.Double class 
method summary, 1076 


java. lang.Error class 
and exception class hierarchy, 504 
method summary, 1076 


java. lang.Exception class 
checked exceptions, 506 
and exception class hierarchy, 504 


java. lang.I1legalArgumentException 
class, 503, 504 
method summary, 1076 
as unchecked exceptions, 506 


java. lang.I]legalStateException class, 504 
method summary, 1076 


java. lang. IndexOutOfBoundsException 
class, 504 | 


java. lang.Integer class 
method summary, 1076-1077 


java. lang. InterruptedException class 
method summary, 1077 


java. lang.MalformedURLException class, 504 


java. lang.Math class 
constants, 142 
mathematical methods, 150z 
method summary, 1077-1079 


java. lang.Nul1PointerException class, 504 
method summary, 1079 
as unchecked exceptions, 506 
java. lang.NumberFormatException class, 504 
catching, 509, 510 
method summary, 1079 
as unchecked exceptions, 506 
java.lang.Object class 
as cosmic superclass, 465-476 
method summary, 1079-1080 
using thread synchronization, 870-871 


java. lang package, 1074-1082 


java. lang.Runnable interface 
method summary, 1080 | 
running threads, 846-847, 851 | 


java. lang.RuntimeException class, 504 
method summary, 1080 
unchecked exceptions, 506 


java.lang.String class, 38-39 
method summary, 1080-1081 


java. lang.System class, 25 
method summary, 1081-1082 


java. lang. Thread class 
method summary, 1082 
using, 847-871 
java. lang. Throwable class 
and exception class hierarchy, 504 
method summary, 1082 


java. lang.UnknownHostException class, 504 


Java library, 10, 11-12, 427 
API documentation, 50-52 
complete listing by package, 1064-1105 
inheritance hierarchy, 1060-1063 
online help, 53 


Java Mail, 909 


java.math.BigDecimal class 
big numbers, 137 
method summary, 1082 


java.math.BigInteger class 
big numbers, 137 
method summary, 1083 


java.math package, 1082-1083 
Java 2 Micro Edition, 881 
java.net.HttpURLConnection class 
method summary, 1083 
using, 906 
java.net package, 364t, 1083-1085 


java.net.ServerSocket class 
method summary, 1083 
using, 898-899 

java.net.Socket class 
method summary, 1084 
using, 894-897 

java.net.URL class 
method summary, 1084 
using, 905 
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java.net.UREConnection class 
method summary, 1084-1085 
using, 905-909 

Java packages, 11-12, 363-369 
class listing by package, 1064-1105 
importing, 365 
importing classes from, 49 
naming, 365-366 
syntax summary, 1117 


Java programs, 15 

JavaScript, 476-477, 690, 766 

JavaServer Faces, 1012 
architecture of applications, 1014-1017 
deploying applications, 1017-1019 
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javax.swing. JComboBox class 
method summary, 1097 
using, 792-794 
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javax.swing.JScro11Pane class 
method summary, 1100 
using, 483 
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JTextField constructor, 1101 
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keyboard, 6, 7 
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keySet method 

java.util.Map interface, 706, 1093 
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length method 
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lightweight Java databases, 933 
LIKE operator, 928 

linear search, 649 
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Line2D.Double constructor, 1069 
LineItem. java, 554, 986 
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line numbers, 499 
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drawing, 61 
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LinkedList. java, 677-681, 770-773 
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Linux, 407 
command line interface, 104 
Graphical Software Environment for, 407 
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shell scripts, 321 
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listIterator method 
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list iterators, 667 
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load method 
java.util.Properties class, 940, 1093 
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saving backups to, 15 
local variables, 104-106 
accessing surrounding, 412 
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style guide for naming, 1055 
lock method 
java.util.concurrent. locks.Lock 
interface, 1095 
lock objects 
for avoiding thread deadlock, 864-871 
calling await without calling 
signalAl1, 869 
calling signalA11 without locking, 869 
for controlling threads, 861-863 
and synchronized methods, 870-871 
logging, 214-215, 447-448 
logical operators, 206-208 
logic errors, 23-24 
log in, 13 
log method 
java. lang.Math class, 150z, 1078 
Long class, 298t 
long keyword, 1122 
long type, 135z, 1107 
wrapper class, 298t 
loop and a half, 248, 251, 253-254, 255 
LoopFib. java, 530-531 
loop invariants, 261-263, 351 
loops, 1114 
correctness proofs, 263 
debugging, 273-274 
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infinite, 232-233 
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for loops, 237-244 
nested, 244-246 
processing sentinel values, 247-249 
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while loops, 228-232 
loosely typed, scripting langauges as, 477 
love bug, 477 
Lovelace, Ada Augusta, Countess, 649 
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machine code 

factor out common, 153 

spaghetti code, 235-236 

translating computer programs into, 8-9 
machine instructions, 8-10 


Mac OS, 407 
command line interface, 104 
grep program, 362 
Java programs will run on, 10 
running Apache Derby, 934 
shell scripts, 321 
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MAGENTA, RGB value, 68z 

magic numbers, prohibited by style guide, 
145, 1050, 1052 

mailto protocol, 1128 

mainframes, 56-57 


main method, 20 
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managed bean, 1021 
manipulated images, 121, 122, 174 
@ManyToMany relationship, 954 
@ManyToOne relationship, 954 
MapDemo. java, 706—/07 

Map interface, 705-707 

maps, 705-707 

Mark II, first bug found in, 274 
markup tags, 965-966 
mathematical methods, 150t 
MathxML, 964 


max method 
java. lang.Math class, 150z, 1078 


Measurer. java, 402 
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memory model, 871 

menu bar, 802 

MenuFrame. java, 801-805 
MenuFrameViewer. java, 801 
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merge sort, 639-642 

analyzing, 642-645 
MergeSortDemo. java, 642 
MergeSorter. java, 640-641 
metaphor, for programming, 534 
method binding, 1032 
method body, 20, 86 
method call, 20, 21 


method documentation 
ATM case study, 562-563 
invoice printing case study, 548-550 


method names, 36, 86 
overloading, 42, 397 
style guide, 1050, 1054 


method parameters 
type variables for, 769 


methods, 19-20, 37-39. See also parameters; 
return values 
access control, 462-465 
and class discovery in design process, 537 
commenting, 90-91 
constant values in, 141 
constructors contrasted, 46 
early and late binding, 398 
implementing, 95-101, 101 
umplicit and explicit parameters, 107-108 
making inherited less accessible, 463-464 
maximum 30 lines of code, 1050, 1052 
modifying signature in 
implementing, 411 
postconditions, 349-350 
preconditions, 347-350 
public interface of class, 85-90 
style guide, 1051-1052 
style guide requires a comment for 
each, 1050 
subclasses, 439 
syntax, 1109 
syntax summary, 1111-1113 
terminates upon throwing of 
exception, 505 
in UML diagrams, 542 
with variable number of parameters, 317 
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Microsoft Access, 933 

Microsoft Networking protocol, 888 

Microsoft SQL Server, 933 

Microsoft Windows, See Windows 
operating system 

middle tier, 1034 

min-heap, 740 

MinHeap. java, 746-749 
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min method 
java. lang.Math class, 1502, 1078 
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ML, 345 


mod method 
java.math.BigInteger class, 1083 


molecule visualization applet, 11 
monitor, 6, 7 
Mosaic browser, 71 
motherboard, 6 
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keyboard shortcuts for 
operations, 195-196 
mouseClicked method 
java.awt.event.MouseListener interface, 
420-421, 1068 
mouseEntered method 
java.awt.event.MouseListener interface, 
422, 1068 
mouse events, 421-425 
mouseExited method 
java.awt.event.MouseListener interface, 
422, 1068 
mousePressed method 
java.awt.event.MouseListener interface, 
421-422, 1068 
mouseReleased method 
java.awt.event.MouseListener interface, 
421-422, 1068 
MoveTester. java, 48 
Mozilla 
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multiply method 
java.math.BigDecimal class, 137, 1082 
java.math.BigInteger class, 137, 1083 


multitasking, 406 
threads for, 845 


multithreading 
algorithm animation case study, 871-880 
deadlock avoidance, 864-871 
race conditions, 855-861 
running threads, 846-852 
synchronizing object access, 861-863 
terminating threads, 852-854 
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tables, 922-924 
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MySQL, 933 
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name clashes, 365 

name spaces, 998, 999 

native keyword, 1122 
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NCR, 56 

necktie collection catalog, 1043 
Needle. java, 259-260 
NeedleSimulator. java, 260 
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if statement, 198-201 
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NetBeans, 802 
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viewing applets, 65 
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networking, 407 
networking package, 12 
network protocol, 888 
network protocol data, 888 
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Factory class, 972, 1103 
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class, 1102 
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Factory class, 972, 1103 


javax.xml1.xpath.XPathFactory class, 


976, 1103 
new keyword, 1122 


newline — 
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new operator, 45, 1119 
newXPath method 


javax.xml.xpath.XPathFactory class, 
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java.util.Random class, 256, 1094 


java.util.Scanner class, 165, 498, 1094 
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java.util.Random class, 256, 1094 


java.util.Scanner class, 165, 206, 498, 
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java.sql.ResultSet interface, 943, 1087 
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binary search trees, 720, 725 


1190 


Index 


nonlinear control flow 
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floating-point numbers, 1140 


NORTH component, BorderLayout, 788, 789 


not equal operator, 1882, 1120 
notifyAll method 
java.lang.Object class, 870, 1080 
notify method 
java.lang.Object class, 870, 1079 
not logical operator, 206, 207, 1119 
and De Morgan’s law, 209 
Novell NetWare protocol, 888 
n™ triangle number, 512 
null reference, 192 
numbers, 43 
big numbers, 137 
formatting, 167-169 
objects contrasted, 54-56 
number systems, 1136-1141 
number types, 43, 134-137 
number variables, 34 


numerical integrator (ENIAC), 8 
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object diagrams, 339 
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object-oriented design, 83-85 
case study: ATM machine, 556-577 
case study: printing invoice, 544-556 
discovering classes, 536-538 
software life cycle, 530-534 
ObjectOutputStream constructor, 1072 
object references, 53-56, 346-347, 461 
forgetting to initialize, 106-107 
object-relational mapping, 954-955 
objects, 19-20, 33, 37-39 
comparing, 191-192 
constructing, 44-46 
numbers contrasted, 54-56 
types and variables, 34-36 
object streams, 833-835 
advantages, 837 
How To use, 836-837 
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omega notation, 639 
omg.org.CORBA, 364t 
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@OneToOne relationship, 954 
online help, 53 
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openConnection method 
java.net.URL class, 905, 1084 


open mode, 827 

open-source databases, 933 
operating systems, 370-371, 406-407 
operator precedence, 696-697 
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Oracle, 933, 935 
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method summary, 1104 
using, 981-983 
org.w3c.dom.DOMConfiguration interface 
method summary, 1104 


org.w3c.dom.DOMImplementation interface 
method summary, 1104 
using, 983 
org.w3c.dom.Element interface 
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using, 982 
org.w3c.dom.1s.DOMImplementationLs 
interface, 983 
method summary, 1105 
org.w3c.dom.1s.LSSerializer interface, 983 
method summary, 1105 
org.w3c.dom.1s package, 1105 
org.w3c.dom package, 1104 
org.w3c.dom.Text interface 
method summary, 1104 
or logical operator, 206, 207, 1120 
binary, 1142z 
confusing with and operator, 208 
lazy evaluation, 208-209 
outcome, of buttons, 1032 
OutOfMemory error, 506 
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output devices, 6, 7 
output redirection, 321 
overflow, of calculations, 134-135 
overlapping scope, 360-361 
overloaded name, 42, 397 
overriding methods, 445 
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package access, 462-463 
accidental, 463 
package keyword, 1122 
packages, See Java packages 
package statement, 1050 
packets, of network data, 889 
paintComponent method 
javax.swing.JComponent class, 60, 62, 
114, 119-120, 421, 1098 
pair programming, 534 
panels, 415 
layout, 788-790 
parallel arrays, 315-316 
parameterized array lists, 297 
parameterized Comparable interface, 656-657 
parameters, 20, 86-87 
commenting, 91 
implicit and explicit, 107-108 
methods with variable number of, 317 
printing out in program tracing, 448 
and return values, 40-42 
style guide for naming, 1051 
trying to modify primitive types, 343-344 
parameter variables, 104-106 
don’t change contents, 345 
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for multiplication, 43 
unbalanced, 152 
parsed character data, 989 
parseDouble method 
java. 1ang.Double class, 159, 1076 
parseInt method 
java. lang. Integer class, 1076 
parse method 
javax.xml.parsers.DocumentBui Ider 
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Factory class, 972 


parsers, 972-981 
and compilers, 980-981 
and validation, 994-995 


parse tree, 978-980 
partially filled arrays, 316-317 
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JSF components, 1030t 
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Pentium-floating-point bug, 139-140 
PermutationGenerator. java, 518-519 
PermutationGeneratorDemo. java, 516-518 
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personal computers, 370-372 

PGP (pretty good privacy), 826-827 

PI constant, java. lang.Math class, 142, 1079 
PINK, RGB value, 682 

Point2D. double constructor, 1069 
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drawing, 61 
polymorphism, 396-398 
and inheritance, 455-459 
and reuse, 387 


port 80, 890, 891 

port 110, 890 

portability, benefit of Java, 10 
port numbers, 890 

ports, 7 

postconditions, 349-350 
@postcondition tag, 350 
posthx operator, 1108 
PostgreSQL, 933 

Post Office Protocol (POP), 890, 893, 894 
postorder traversal, 732, 733 


pow method 
java. lang.Math class, 149, 150t, 1078 


precedence, of operators, 696-697, 1108 
preconditions, 347-350 

predicate methods, 205-206 

prefix operator, 1108 

preorder traversal, 732 
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preparedStatement method 
java.sql.Connection interface, 941, 1085 


presentation logic, JSF pages, 1017 
presentation tier, 1034 
previous method 
java.util.ListIterator interface, 
669, 1092 
primary colors, 67 
primary key, 920 
and indexes, 921-922 
primary storage, 4 
primitive types, 43, 83, 134, 1352, 1107 
trying to modity, 343-344 
wrappers and auto-boxing, 298-299 
printer, 6, 7 
printf method 
java.io.PrintStream class, 1073 
and number formatting, 167-168 
printing, 407 
printin method 
to inspect current state of objects, 467 
java.io.PrintStream class, 20, 25, 38, 
1072 
java.io.PrintWriter class, 498, 1073 
passing parameter to, 40 


print method 
generic, 776-777 
java.io.PrintStream class, 21, 38, 1072 
java.io.PrintWriter class, 498, 1073 


printStackTrace method 
java. lang. Throwable class, 510, 1082 


PrintWriter constructor, 1073 
PriorityQueue constructor, 1093 
priority queues, 739-740 
private implementation, 39 
private keyword, 1122 


private modifier, 18 
access control, 462 
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public or private, 1051 
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Product.sql, 945 
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program comparator, 608 
program loading, 406 


programmers 
first, 647-648 
productivity, 535 
programming, 2-3. See also generic 
programming 
defensive, 24 
make schedule and make time for 
unexpected problems, 203 
with packages, 368-369 
programming languages, 426-427 
program trace, 447 
Project Gutenberg, 70 
prompt, 104, 165 
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protected access, 462, 464-465 
protected attribute, 1051 
protected keyword, 1122 
protocols, 70 
prototypes, 532-533 
pseudorandom numbers, 258 
public key encryption, 826 
public keyword, 1122 
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access control, 462 
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put method 
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race conditions, in threads, 855-861 
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random access 
files, 827-833 
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RandomAccessFile method 
java.io.RandomAccessFile class, 1073 


random-access memory (RAM), 4, 6, 7, 406 
Random constructor, 1094 

random number generator, 256 

random numbers, 256-261 

Random object, 337 

Rational Unified Process method, 533 

raw types, 780 

RCA, 56 


readChar method 
java.io.RandomAccessFi le class, 1074 


readDouble method 


java.io.RandomAccessFi le class, 828, 
1074 


readiInt method 


java.io.RandomAccessFi le class, 828, 
1074 


read method 
java.io. InputStream class, 821, 1071 
java.io.Reader class, 821, 1074 


readObject method 


java.io.ObjectInputStream class, 833, 
1072 


read-only property, 1020 
realistic planning, 533 


recovery, from program failure 
and throwing exceptions, 503 


RectangleAppletExplained. java, 64 
RectangleApplet.html, 64 
RectangleApplet. java, 63-64 


RectangleComponent. java, 61-62, 419, 
422-423 


RectangleComponentViewer. java, 424-425 
Rectangle constructor, 1067 
RectangleMeasurer. java, 402 
RectangleMover. java, 420-421 


rectangles 
constructing, 44-45, 61 
How To draw, 117-120 


RectangleViewer. java, 62 
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recursion, 511 
efficiency, 526-532 
How To Think Recursively, 521-524 
infinite, 516 
mutual, 532-538 
permutations, 516-520 
triangle numbers, 512-515 


recursive computation, 513 
RecursiveFib. java, 526-528 
RecursiveFibTracer. java, 528-529 
recursive helper methods, 524-526 


recursive methods, 513-514, 1113 
tracing through, 520 


recursive solution, 513 

recursive thinking, 521-524 

RED, RGB value, 68t 

red-black trees, 727 
ReentrantLock constructor, 1095 
refactoring, 534 

reference, to object, 53-56 
reference parameter, 346 
reference types, 1107 

regression testing, 319-321, 443-445 
regular expressions, 362-363 


relational database, 916. See also database 
queries; database tables 


relational operators, 188, 188 
using multiple, 207-208 

relationships 
between classes, 536, 539-542 
UML relationship symbols, 541¢ 
visualization, 339 

Relax NG, 999 

removable storage, 6 

removeFirst method 
java.util.LinkedList class, 667, 673, 

675, 1092 

removeLast method 

java.util.LinkedList class, 667, 1092 


remove method 
java.util.ArrayList class, 294, 1089 
java.util.Collection interface, 1090 
java.util.Iterator interface, 669, 674— 
676, 1091 
java.util.Map interface, 706, 1093 
java.util.PriorityQueue class, 739, 1093 
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remove method, cont. 
Set interface, 702 


rendering, of code by Web browser, 1125 


repaint method 
forgetting to repaint, 421 
java.awt.Component class, 1065 


replace method 
java.lang.String class, 41-42, 1081 


reporting, and throwing exceptions, 503 


requirements document, 530 
ATM case study, 556-558 
invoice printing case study, 544-545 


requirement specification, 531 
reserved words, 35 
responsibilities 

of classes, 536, 537 

in CRC card methods, 537-538 


restoring, 16 

result set, 931 

result set meta data, 944-947 
return keyword, 1122 


return statement, 97, 1114 
Unicode for, 10572 


return type, 86-87 
return values, 40-42 
commenting, 91 
printing out in program tracing, 448 
testing, 102 
type variables for, 769 
reuse, 487 
and inheritance, 440 
interfaces for, 388-393 
and polymorphism, 387 
reverse Polish notation (RPN), 734-735 
RGB values, of colors, 68t 
Rhino Script, 477 
right children, 720 
rollback method 


java.sql.Connection interface, 953, 1085 


root nodes, 720 
rounding errors, 135, 138, 155 
round method 


java.lang.Math class, 136, 150z, 154, 1078 


rows, in relational database tables, 916-917 
avoid replicated data in rows, 919 


RSA encryption, 825-826 


run method 
java. lang. Runnable interface, 846, 851, 
1080 


run-time error, 23-24, 27 
run-time stack, 687 
Russian alphabet, 163 


S 
safety, benefit of Java, 10 
saving, 15 
SavingsAccount. java, 459 
SAX (Simple API for XML) parsers, 980 
Scanner constructor, 1094 
Scanner object, 337 
scenes, 121, 122 
schema languages, 998-999 
Scheme, 345, 689 
scientific method, 577 
scientific notation, 43 
scope 
class members, 359-360 
local variables, 358-359 
overlapping, 360-361 


scripting languages, 476-478 
scroll bars, 483 


searching, 649-651. See also binary search; 
sorting 


secondary indexes, 922 
secondary storage, 4 


seek method 
java.io.RandomAccessFi le class, 828, 
1074 


SELECT command (SQL), 926-931 
selection operator, 187 


selection sort, 628-631 
performance analysis, 635-637 
profiling, 631-635 


SelectionSortComponent. java, 876-877 
SelectionSortDemo. java, 630 
SelectionSorter. java, 629-630, 877-880 
SelectionSortTimer. java, 633-635 


SelectionSortViewer. java, 876 


self-call, 359 
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self-organizing data structures, 725 
semicolons, 20 
forgetting in loops, 242 
omitting, 22 
style guide, 1055 
too many in loops, 242 
sentinel values, 247-249 
sequential access 
files, 827 
linked lists, 666, 684, 685 
sequential search, 649 
SerialDemo. java, 834-835 
serialization, 834 
geometric objects, 837 
server program, 897-904 
ServerSocket constructor, 1083 
session state, 1028-1029 
setAttribute method 
org.w3c.dom.Element interface, 982, 1104 
setAutoCommit method 
java.sql.Connection interface, 953, 1085 
setBorder method 
javax.swing.JComponent class, 1098 
setColor method 
java.awt.Graphics class, 67, 1066 
setDefaultCloseOperation method 
javax.swing. JFrame class, 58-59, 1098 
SetDemo. java, 703—/04 
setDouble method 
java.sql.PreparedStatement interface, 
941, 1086 
setEditable method 
javax. swing. JComboBox class, 792, 1097 
javax.swing.JTextComponent class, 483 
javax.swing.text.JTextComponent class, 
1102 
setFont method 
javax.swing. JComponent class, 1098 
setIfModifiedSince method 
java.net.URLConnection class, 906 
setIgnoringElementContentwWhitespace 
method 
javax.xml.parsers.DocumentBui IderFact 
ory class, 995, 1103 
Set interface, 701-705 
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setint method 


java.sql.PreparedStatement interface, 
941, 1086 


set iterators, 702 


setJMenuBar method 
javax.swing. JFrame class, 1098 


setLayout method 
java.awt.Container class, 788-789, 1065 


setLevel method 
java.util. logging.Logger class, 215, 
448, 1096 


setLine method 
java.awt.geom.Line2D class, 1069 


setLocation method 
java.awt.geom. Point2D class, 1069 
java.awt.Rectangle class, 1067 


set method 
java.util.ArrayList class, 293, 685, 1089 
java.util.ListIterator interface, 
676-677, 1092 
setModi fiedSince method 
java.net.URLConnection class, 1085 
setParameter method 
org.w3c.dom.DOMConfi guration interface, 
1104 
setPreferredSize method 
java.awt.Component class, 487, 1065 


sets, 700-705 


setSelectedItem method 
javax. swing. JComboBox class, 793 


setSelected method 


javax.swing.AbstractButton class, 
791, 1096 


setSize method 
java.awt.Component class, 1065 
java.awt.Frame class, 58 
setString method 
java.sql.PreparedStatement interface, 
941, 1086 
setText method 
javax.swing.text.JTextComponent class, 
483, 1102 
setTimeZone method 
java.text.DateFormat class, 1023, 1088 
setTitle method 
java.awt.Frame class, 58, 1066 
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setValidating method 
javax.xml.parsers.DocumentBui Ider- 


Factory class, 994-995, 1103 


setVisible method 
java.awt.Component class, 1065 


Seven Dwarts, 56, 57 


shadowing, 360-361 
instance fields, 449-450 
shallow copy, 473-474 
shapes, 65-70 
drawing, 59-62 
drawing complex, 68-70, 112-120 
How To draw graphical, 117-120 


shell scripts, 321, 445 
shell window, 13 
shift left, 1120, 1144 
shift operations, 1144 
shift right, 1120, 1144 
Short class, 298z 
short keyword, 1122 
short type, 135z, 1107 
wrapper class, 298t 
showInputDialog method 
javax.swing. JOptionPane class, 340, 1099 
showMessageDialog method 
javax.swing.JOptionPane class, 340, 1099 
showOpenDialog method 
javax.swing.JFileChooser class, 
501, 1098 
showSaveDialog method 
javax.swing.JFileChooser class, 
501, 1098 
side effects 
of conditions, 193 
of methods, 341-342 
minimizing, 342, 345 
signalAll method 
java.util.concurrent. locks.Condition 
interface, 865-866, 869, 1095 
signal method 
java.util.concurrent. locks.Condition 
interface, 866, 1095 
sign bit, 821 
signed magnitude integers, 1138 
signed type, 821-822 
SimpleDataSource. java, 937-938, 940 


Simple Mail Transfer Protocol (SMTP), 893 
simple statement, 184 

simplicity, 534 

simulation, 256-261 

single-step command, 266 

single-valued relationship, 922 


sin method 
java. lang.Math class, 150z, 1078 


size method 
java.util.ArrayList class, 293, 1089 
java.util.Collection interface, 1090 


Skipjack, 826 


sleep method 
java. lang. Thread class, 848, 853, 1082 


sliders 
colors, 809-811 


small releases, 533 

smart cell phones, 881 

SMTP (Simple Mail Transfer Protocol), 893 
Social Security Act of 1935, 932 

Social Security numbers, 932-933 

Socket constructor, 894, 1084 

sockets, 894-897 

software components, 1020 


software development, 530-534 
art or science?, 577-578 
spiral model, 532-533 
watertall model, 531-532 
software life cycle, 530-534 
software piracy, 738-739 
sorting, 627 
real data, 654-656 
sorting algorithms, 628 
insertion sort, 637-638 
merge sort, 639-645 
quicksort, 645-647 
selection sort, 628-637 
sort method 
java.util.Arrays class, 645, 647, 654, 
1089 
java.util.Collections class, 655, 1090 
sound card, 7 
sound package, 12 
source code, 25 


index 


source files 
backing up, 16 
style guide, 1050 
SOUTH component, BorderLayout, 788, 789 
spaces 
style guide for using, 1050, 1055 
Unicode for, 1057t 
spaghetti code, 235-236 
speakers, 6, 7 
spelling check, 25 
spiral model, of software 
development, 532-533 
SPL/1, 426 
SQL (Structured Query Language), 
364t, 916-917 
forgiving nature of some 
implementations, 918 
standard types, 917t 
statement execution, 941-942 
SQL data types, 917t 
sqrt method 
java. lang.Math class, 149, 150z, 154, 1078 
as static method, 352 


square 
How To draw, 117 


squelching exceptions, style guide says use 
throws specification instead, 1054 

stack-based calculator, 734 

Stack class, 687 

stacks, 686-688 

standardization, 689-690 


start method 
java.applet.Applet class, 1064 
java. lang. Thread class, 847, 851, 1082 
javax.swing.Timer class, 1101 


stateChanged event, 811, 1101 


statements, 20 
syntax summary, 1114-1116 


static constants, 356 


static fields, 354-356, 1051 
cannot use type variables to define, 782 
syntax summary, 1110 


static imports, 363 


static inner classes, 682 
cannot use type variables to define, 782 


static keyword, 1122 
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static methods, 352-353, 1051, 1112 
calling, 153-154 
cannot use type variables to define, 782 
main must always be, 19 
no implicit parameters, 108 


static variables 
avoid whenever possible, 1051 


step into, 266 
step over, 266 


stop method 
java.applet.Applet class, 1064 
javax.swing.Timer class, 1101 
StopWatch. java, 632-633 
storage, of data, 4-5, 6, 7 
storage tier, 1034 
streaming media, 890 
streaming parsers, 972 
strictfp keyword, 1122 
StringIndexOutOfBoundsException, 160 
strings, 21, 158-165 
array of, 776 
and char type, 162 
comparing, 189-191 
hash codes, 708t 
number of elements, 297t 
style guide, 1049-1056 
subclasses, 439 
confusing with superclasses, 442 
construction, 451-452 
converting to superclass type, 452-454 


inheriting instance fields and methods, 
445-450 


subclass references, 452 
submenus, 802 


submit button, JSF component, 1030z, 
1031-1032 


subset, 442 


substring method 
java.lang.String class, 159, 1081 


subtraction, 148 


subtract method 
java.math.BigDecimal class, 137, 1082 
java.math.BigInteger class, 137, 1083 


summary table, 91, 92 
Sun Microsystems, 10-12, 57 
superclass constructor, 451 
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superclasses, 439 
confusing with subclasses, 442 
converting to subclass type, 452-454 
inheriting instance fields and methods, 
445-450 
java.lang.Object class as “cosmic,” 
465-476 


superclass method, 448 
failing to invoke, 450 


superclass references, 452 

super keyword, 448, 450, 451, 1123 
superset, 442 

supplementary characters, 162 
swapping, in sorting, 628-629 
SwingConstants interface, 394 
Swing documentation, 808-814 
SwingSet demo, 809 

switch keyword, 1123 


switch statement, 197-198 
syntax summary, 1115 


Syl lableCounter. java, 269 
symmetric bounds, 252 
synchronized keyword, 870, 1123 
synchronized methods, 870-871 


syntax 
array construction, 290 
array element access, 291 
assertion, 349 
assignment, 37 
block statement, 185 
calling superclass constructor, 451 
calling superclass method, 449 
cast, 136 
class definition, 89 
constant definition, 142 
constructor definition, 89 
defining enumerated types, 204 
defining generic classes, 770 
defining generic methods, 777 
for each loop, 301 
exception specification, 508 
finally clause, 512 
general try block, 509 
if statement, 184 
importing class from package, 49 
inheritance, 441 


inner classes, 403 
instance field declaration, 95 
instanceof operator, 454 
instantiating generic classes, 767 
interface definition, 392 
interface implementation, 392 
method call, 21 
method definition, 89 
object construction, 45 
package specification, 364 
return statement, 97 
for statement, 237 
static method call, 154 
throwing exception, 505 
variable definition, 35 
while statement, 232 
syntax diagrams, 533-534 
syntax.error 25=24;, 27 
syntax summary, 1107-1118 
syntax trees, 533-534 
System.in object, 165 
System.out object, 20, 25, 38-39, 165 
system output, 20 
system programmers, 50 


T 
tables, See database tables 


tabs 
and indentation, 186-187 
style guide for setting, 1050, 1055 
Unicode for, 10572 


TACPOL, 426 
tail, of queue, 686 


tan method 
java. lang.Math class, 150z, 1079 


tapes, for data storage, 6 
TaxCalculator. java, 201 
TaxReturn. java, 200-201 


TCP/IP (Transmission Control Protocol 
over Internet Protocol), 70, 889, 890 


Telnet program, 891-892 
term syntax diagram, 533 
ternary operators, 1108 


terrorism 
and encryption, 826 


index 


test.bat, 445 

TestCase class, JUnit, 372-373 

test cases, 203 
calculate sample data manually, 213 
prepare ahead of time, 214 

test coverage, 212-213, 444-445 

TestDB. java, 937 

tester class, 102 

test harness, 445 


testing 
classes, 101 
computations, 157 
and Extreme Programming, 534 
implementing test program, 47-49 
interactive, 49, 102 
make schedule and make time for 
unexpected problems, 203 
for null reference, 192 
regression testing, 319-321, 443-445 
test coverage, 212-213, 444-445 
unit test frameworks, 372-374 
unit testing, 102-103 
unit testing with JUnit tool, 446-447 
testing phase, of software life cycle, 530, 531 
test suite, 319 
TpX, 965-966 
text 
How To draw, 118 
processing input events, 480-483 
reading and writing files, 498-501 


text areas 
JSF components, 1030z 


text fields, 480 
graphical user interfaces, 483-485 
How To example, 799-801 
JSF components, 1030 
Web applications, 1010 


text format, 820-821 

texture modeling, 122 

Thai alphabet, 164 
theorem-proving programs, 211 
Therac-25 incidents, 322-323 
theta notation, 639 

this keyword, 1123 


this reference, 110 
for shadowing, 360 
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thread pools, 851-852 
threads 


check for interruptions in run method 
of thread, 854 

deadlock avoidance, 864-871 

running, 846-852 

synchronizing object access, 861-863 

terminating, 852-854 


thread scheduler, 850 

thread synchronization, 870-871 
three-tier web applications, 1034-1042 
Throwable constructor, 1082 

throwing exceptions, 503-505 

throw keyword, 1123 


throws, 348 
style guide for using, 1054 


throws keyword, 1123 

throws specifier, 507 

throw statement, 505, 1114, 1116 
TicTacToe. java, 307-308 
TicTacToeRunner. java, 308-309 
Timer constructor, 1101 

timers, 418-419 

time slice, 850 

time stamp, 847 

TimeZoneBean. java, 1023-1025, 1038-1042 
timezone/index.jsp, 1025-1026 


timezone/WEB-INF/classes/bigjava/ 
TimeZoneBean. java, 1023-1025 


timezone/WEB-INF/faces-config.xml, 1025 
TitledBorder constructor, 1101 


toDegrees method 
java.lang.Math class, 150t, 1079 


toLowerCase method 
java.lang.String class, 1081 


toRadians method 
java.lang.Math class, 150t, 1079 


toString method 
and inheritance, 467-468 
java. lang.Enum class, 476 
java. lang.Integer class, 138, 1077 
java.lang.Object class, 439, 4652, 498, 
1080 
overriding, 466-467 
supply to all classes, 467 
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total ordering relationship, 655 
touch screen voting machine, 110, 112 


toUpperCase method 
java.lang.String class, 39, 341, 1081 


trace messages, 215, 527 
transactions, 952-953 


transformation, of XML 
documents, 999-1000 


transient keyword, 1123 
transistors, 4 


translate method 
java.awt.Rectangle class, 46-47, 52, 
55, 1067 


Transmission Control Protocol (IT'CP), 
889-890 


Transmission Control Protocol (TCP) 
over IP (TCP/IP), 889, 890 


tree-based parsers, 972 
TreeMap constructor, 1095 
tree maps, 735-737 


trees, 701 
turning into heaps, 752 


TreeSet constructor, 1095 
tree sets, 735-737 
TreeSetTester. java, 736-737 
tree traversal, 731-734 
Triangle. java, 245, 514-515 
triangle numbers, 512-515 
TriangleRunner. java, 246 
TriangleTester. java, 515 
true, boolean type, 205 


try block, 508-511, 1114 
and finally clause, 512 


try/catch statement, 508-511 
syntax summary, 1116-1117 


try keyword, 1123 
Turing machine, 608-609 
two-dimensional arrays, 306-309 
two’s complement integers, 1138-1139 
two-tier client-server architecture, 1035 
type parameter, 293 

syntax summary, 1118 
types, 34-36 

syntax summary, 1107 


typesetting systems, 964-966 
type variables, 766-767 


U 


constraining, 777-779 

generic methods, 776 

implementing generic classes, 768-770 
wildcard types, 779 


UML (Unified Modeling Language), 339 
UML diagrams 


ATM case study, 561-562 
attributes and methods in, 542 
and CRC cards, 541-542 
Invoice printing case study, 548 


UML notation, 540 


summary, 1145-1146 


UML relationship symbols, 5412, 1146¢ 
unary negation operation, 1142 


unary operators, 1108, 1119 


unbalanced trees, 726 
unbounded wildcard, 779 
unchecked exceptions, 506-508 


undefined symbol error, 25 
Unicode, 162, 822 


Basic Latin (ASCII) subset, 1058z 
code unit, 162 

Latin-1 subset, 1059z 

selected control characters, 1057t 


Uniform Resource Locator (URL), 891 
uninitialized arrays, 292 


uninitialized variable error, 37 


union method 


java.awt.Rectangle class, 1067 


unit test frameworks, 372-374 
unit testing, 102-103 


with JUnit tool, 446-447 


Univac Corporation, 56 


Universal Resource Locator, See URL 
Unix 


class path, 367 

command line interface, 104 

file separator, 369 

finger program, 318 

grep program, 362 

Java programs will run on, 10 

performance with large or random data 
sets, 315 


Index 


Unix, cont. 
running Apache Derby, 934 
shell scripts, 321, 445 
Telnet program, 891 


unlock method 
java.util.concurrent. locks.Lock 
interface, 1095 


unstable layout, 147, 1056 
UPDATE command (SQL), 931 


URL (Universal Resource Locator), 1128 
for databases, 936 
supplying external DTD for XML 
documents, 994 


URLConnection constructor, 1084 
URL connections, 905-909 
URL constructor, 1084 
URL encoding, 1011 
URLGet. java, 907-908 
user interface, 371. See also graphical user 
interfaces (GUIs) 
events, event sources, and event 
listeners, 407-410 
user-interface components, 788 
user interface design package, 12 
user interface prototype, 533 
uses relationship, 392, 540 
utility class, 337 


V 

vacuum tubes, 7 

value attribute, JSF components, 1029-1030 
value binding, 1016-1017 

value set, 705 


variable names, 34-35, 36 
style guide, 1050, 1054, 1055 
style summary, 1108 
use descriptive, 145 


variables, 34-36 
accessing surrounding, 412 
all non-final must be private, 1051 
assignment operator, 36-37 
categories of, 104-106 
compiler assigns memory location, 9 
inspecting with debugger, 265-266 
lifetime, 105 
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style guide, 1052-1053 
syntax summary, 1108 
variable type, 34-36 
virtual memory, 406 
VisiCalc, 370, 371 
Visual Basic Script, 476, 477 
void keyword, 1123 
volatile keyword, 1123 
voter verifiable audit trail, 111 


VRML, 964 


W 


wait method 
java.lang.Object class, 870, 1080 


waterfall model, of software 
development, 531-532 


Web applications, 1009. See also Java Beans; 
JavaServer Faces 
architecture, 1010-1013 
client program, 894-897 
high-level library applications, 909 
How To build, 1033-1034 
How To client-server program 
design, 904-905 
navigation between pages, 1031-1033 
server program, 897-904 
three-tier, 1034-1042 
URL connections, 905-909 
Web-based user interfaces, 1009 
Web browsers, 1010 
and application protocols, 890-894 
interpretation of code by, 1125 
View Source option, 1015 
WebGet. java, 895-897 
Web links, 1010 
web.xml, 1019 
WEST component, BorderLayout, 788, 789 
while keyword, 1123 
whi le loops, 228-232 
break and continue, 254-255 
consider using in place of for loops, 241 
How To implement, 250-252 
and spaghetti code, 235-236 
syntax summary, 1115 
while statement, 228-229 
use spaces around (...) part, 1055 
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WHITE, RGB value, 68¢ 
white-box testing, 212, 444 
white space, 152-153, 165 
style guide, 1055 
use in HTML, 1126 
wildcard types, 779, 1118 
wildcard with lower bound, 779 
wildcard with upper bound, 779 
windows, 407 
Windows operating system, 407 
batch files, 445 
class path, 367 
as de-facto standard, 690 
file separator, 369 
grep program, 362 
Java programs will run on, 10 
keyboard shortcuts for operations, 196 
Windows XP, 203 
command line interface, 104 
wireless networks, 888 
WithdrawRunnable. java, 859-860 
Word. java, 267-269 
word processing, 964—966 
word processor, 964 
WorkOrder. java, 750-751 
workstations, 57 
World Wide Web, 70-71, 887 
TCP used by, 890 
World Wide Web Consortium (W3C), 689 
wrappers, 298-299 
writeChar method 
java.io.RandomAccessFile class, 1074 
writeChars method 
java.io.RandomAccessFile class, 1074 
writeDouble method 
java.io.RandomAccessFi le class, 828, 
1074 
writeInt method 
java.io.RandomAccessFi le class, 828, 
1074 
write method 
java.io.OutputStream class, 821, 1072 
java.io.Writer class, 821, 1074 


writeObject method 
java.io.ObjectOutputStream class, 1072 


write-only property, 1020 


writeToString method 
org.w3c.dom.1s.LSSerializer interface, 
983, 1105 


WYSIWYG (what you see is what you get), 
964-965, 1129 


X 
XHTML (Extensible HyperText Markup 
Language), 999, 1126 
XML (Extensible Markup Language), 
961-962 
advantages, 962-963 
HTML contrasted, 963-964 


XML declaration, 966 


XML documents, 962-963 
creating, 981-988 
How To design, 968-970 
parsing, 972-981 
structure, 966-968 
validating, 988-995 
writing, 986-988 
XML document type definitions, 988-993 
How To write, 996-998 
specifying in XML document, 993-994 


XML elements, 967 
describe instance fields, not classes, 
977-978 
preferred over attributes, 970-971 


XML markup tags, 965-966 
XML Schema Definition, 998-999 
XML tag pairs, 963 


xor logical operator 
binary, 1142t 


XPath, 973-977 


XSL (Extensible Stylesheet Language), 
999-1000 


Y 
YELLOW, RGB value, 68z 


lilustration Credits 


Chapter 1 


Page 4: Copyright © 2007, Intel Corporation. 

Page 5 (top): PhotoDisc, Inc./Getty Images. 

Page 5 (bottom): PhotoDisec, Inc./Getty Images. 

Page 6: Copyright © 2007, Intel Corporation. 

Page 8: Courtesy of Sperry Univac, Division of Sperry Corporation. 
Chapter 2 


Page 57: Corbis Digital Stock. 


Chapter 3 


Page 111: David Young-Wolft/PhotoEdit. 

Page 112: Bob Daemmrich/The Image Works. 

Page 117: Punchstock. 

Page 121: Copyright © 2001-2007 Lev Givon. All rights reserved. 
Page 122 (top): Keith Kapple/SUPERSTOCK. 

Page 122 (bottom): Daniel Biggs/SUPERSTOCK. 


Chapter 5 
Page 205: © 2007 Sidney Harris. 


Chapter 6 
Page 275: Naval Surface Weapons Center, Dahlgren, VA. 


Chapter 8 


Page 371: Visicalc screen capture © IBM Corporation. Used with permission. 


Chapter 11 
Page 520 (left, center, right): © AP/Wide World Photos. 


1204 


Iiustration Credits 


Chapter 12 
Page 533: Unified Modeling Language Users Guide (AW Object Tech Series), © 1999 Pearson 


Education, Inc. Reprinted by permission of Pearson Education Inc. Publishing as Pearson 
Addison Wesley. 
Chapter 13 


Page 609: Science Photo Library/Photo Researchers. 


Chapter 14 
Page 648: Topham/The Image Works. 


Chapter 15 
Page 687: Photodisc/Punchstock. 


Chapter 16 
Page 735: Courtesy of Nigel Tout. 


Chapter 20 


Page 863: Creatas/Punchstock. 
Page 881: Courtesy of Professor Naehyuck Chang, Computer Systems Lab, Department of 
Computer Engineering, Seoul National University. 


Chapter 24 


Page 1013: Google Earth™ mapping service screenshot © Google, Inc., reprinted with 
permission. | 


